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committee members voted for approval. At the time it approved this standard, INCITS had the following 
members: 


INCITS Technical Committee T10 on SCSI Storage Interfaces, which developed and reviewed this standard, had 
the following members: 

John B. Lohmeyer, Chair 
William Martin, Vice-Chair 
Ralph O. Weber, Secretary 


Organization Represented 
Amphenol Corporation. 


Avago Technologies 


Brocade. 

Dell, Inc. 


Name of Representative 
Gregory McSorley 
David Chan (Alt) 

Paul Coddington (Alt) 
Zhineng Fan (Alt) 

Adrian Green (Alt) 

Martin Li (Alt) 

Chris Lyon (Alt) 

Alex Persaud (Alt) 

Chansy Phommachanh (Alt) 
Michael Wingard (Alt) 

CN Wong (Alt) 

Matt Wright (Alt) 

John Lohmeyer 
Patrick Bashford (Alt) 

Brad Besmer (Alt) 

Srikiran Dravida (Alt) 
Bernhard Laschinsky (Alt) 
Harvey Newman (Alt) 
George Penokie (Alt) 

Sumit Puri (Alt) 

Robert Sheffield (Alt) 

Ross Stenfort (Alt) 

Bill Voorhees (Alt) 

David Peterson 
Scott Kipp (Alt) 

Steven Wilson (Alt) 

Kevin Marks 
Mark Bokhan (Alt) 

Gary Kotzur (Alt) 

Bill Lynn (Alt) 

Ash McCarty (Alt) 

Daniel Oelke (Alt) 


Working Draft PCI Express® Queuing Interface -2 







| 16 April 2015 T10/BSR INCUS 507 Revision 01 

EMC Corporation.Gary Robinson 

David Black (Alt) 

George Ericson (Alt) 

Mickey Felton (Alt) 

Marlon Ramroopsingh (Alt) 

FCI Electronics.Donald Harper 

Brad Brubaker (Alt) 

Paul Rubens (Alt) 

Dave Sideck (Alt) 

Foxconn Electronics.Fred Fons 


Gary Hsieh (Alt) 

Glenn Moore (Alt) 

Mike Shu (Alt) 

Miller Zhao (Alt) 

Fujitsu America Inc.Kun Katsumata 

Osamu Kimura (Alt) 

Mark Malcolm (Alt) 

Gene Owens (Alt) 

Sandy Wilson (Alt) 

Futurewei Technologies Inc.Alan Yoder 

Xiaoyu Ge (Alt) 

Xiaoyan He (Alt) 

Jia Shi (Alt) 

HengLiang Zhang (Alt) 

Hewlett-Packard Company.Curtis Ballard 

Wayne Bellamy (Alt) 

Chris Cheng (Alt) 

Rob Elliott (Alt) 

Joe Foster (Alt) 

Barry Olawsky (Alt) 

Han Wang (Alt) 

Jeff Wolford (Alt) 

HGST.Joe Breher 

David Brewer (Alt) 

Frank Chu (Alt) 

Jason Gao (Alt) 

Chet Mercado (Alt) 
Nadesan Narenthiran (Alt) 
Paul Suhler (Alt) 

IBM Corporation.Kevin Butt 

Mark And resen (Alt) 

Mike Osborne (Alt) 

Ted Vojnovich (Alt) 

Intel Corporation.Pak-Lung Seto 

Richard Mellitz (Alt) 

KnowledgeTek Inc.Dennis Moore 

Hugh Curley (Alt) 

Marvell Semiconductor Inc.David Geddes 

Wei Liu (Alt) 

Paul Wassenberg (Alt) 
Wei Zhou (Alt) 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 














| T10/BSRINCITS 507 Revision 01 


16 April 2015 


Micron Technology Inc.John Geldman 

Jerry Barkley (Alt) 

Andrew Dunn (Alt) 

Neal Galbo (Alt) 

Michael George (Alt) 

Alan Haffner (Alt) 

Daniel Hubbard (Alt) 

Carl Mies (Alt) 

Niels Reimers (Alt) 

Bob Warren (Alt) 

Microsoft Corporation.Calvin Chen 

Paul Luber (Alt) 

Bryan Matthew (Alt) 

Steve Olsson (Alt) 

Lee Prewitt (Alt) 

Molex Inc.Jay Neer 

Cong Gao (Alt) 

Michael Rost (Alt) 

Darian Schulz (Alt) 

NetApp Inc.Frederick Knight 

Chris Fore (Alt) 

Jaimon George (Alt) 
Subhash Sankuratripati (Alt) 
Ali Yavari (Alt) 

Oracle.Dennis Appleyard 

Jon Allen (Alt) 

Seth Goldberg (Alt) 

Martin Petersen (Alt) 

Phi Tran (Alt) 

Lee Wan-Hui (Alt) 

PMC-Sierra.Tim Symons 

David Allen (Alt) 

Paul Borsetti (Alt) 

Graeme Boyd (Alt) 

Steve Gerson (Alt) 

Bill Lye (Alt) 
le-Wei Njoo (Alt) 

Keith Shaw (Alt) 

Gregory Tabor (Alt) 

Neil Wanamaker (Alt) 

Rod Zavari (Alt) 


Quantum Corporation.Paul Stone 

Rod Wideman (Alt) 

Samsung Semiconductor Inc (SSI).William Martin 


Judy Brock (Alt) 
HeeChang Cho (Alt) 
KeunSoo Jo (Alt) 
Sreenivas Krishnan (Alt) 
Sung Lee (Alt) 

Bhavith M.P. (Alt) 

Truong Nguyen (Alt) 
Santosh Singh (Alt) 

SanDisk IL Ltd.Avraham Shimor 

Dave Landsman (Alt) 
Yoni Shternhell (Alt) 


xii Working Draft PCI Express® Queuing Interface-2 












| 16 April 2015 T10/BSR INCUS 507 Revision 01 

I Seagate Technology.Gerald Houlder 

Michael Connolly (Alt) 


Alvin Cox (Alt) 

Martin Czekalski (Alt) 
Neil Edmunds (Alt) 
Timothy Feldman (Alt) 
John Fleming (Alt) 

Jim Hatfield (Alt) 
Parag Maharana (Alt) 
Alan Westbury (Alt) 
Judy Westby (Alt) 

TE Connectivity.Dan Gorenc 

Mike Davis (Alt) 
Michael Fogg (Alt) 
Tom Grzysiewicz (Alt) 
John Hackman (Alt) 
Kyle Klinger (Alt) 
Doron Lapidot (Alt) 
Joel Meyers (Alt) 

Andy Nowak (Alt) 

Eric Powell (Alt) 

Yasuo Sasaki (Alt) 
Scott Shuey (Alt) 
Robert Wertz (Alt) 

Toshiba America Electronic Components Inc.Mike Fitzpatrick 

Dan Colegrove (Alt) 
Patrick Hery (Alt) 

Don Jeanette (Alt) 

Yuji Katori (Alt) 

Tom McGoldrick (Alt) 
Scott Wright (Alt) 

VMware Inc.Neil H. MacLean 

Murali Rajagopal (Ait) 
Ahmad Tawil (Alt) 

Western Digital Corporation.Curtis Stevens 

James Borden (Alt) 
Marvin DeForest (Alt) 
Michael Koffman (Alt) 
Larry McMillan (Alt) 
Ralph Weber (Alt) 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 








| T10/BSRINCITS 507 Revision 01 


16 April 2015 


INTRODUCTION 


The PCI Express® Queuing Interface - 2 (PQI-2) standard is divided into the following clauses: 

Clause 1 (Scope) describes the relationship of this standard to the SCSI standards and PCI Express 
specifications. 

Clause 2 (Normative references) provides references to other standards and specifications. 

Clause 3 (Definitions, symbols, abbreviations, and conventions) defines terms and conventions used 
throughout this standard. 

Clause 4 (General concepts) defines data field requirements used throughout this standard. 

Clause 5 (Model) describes PQI classes, the queuing model, OQ service notification methods, the PD (PQI 
device) state machine, register based error information and PQI reset. 

Clause 6 (PCI Express requirements and PQI device registers) describes PCI Express requirements and 
PQI device registers. 

Clause 7 (Queuing layer) describes the IQ Cl, IQ PI, OQ Cl, and OQ PI structures. 

Clause 8 (SGL (scatter gather list)) describes SGLs, SGL segments, and SGL descriptors. 

Clause 9 (Common properties for all IU layers) describes common properties for all IU layers. 

Clause 10 (Administrator lUs and administrator functions) describes the administrator lUs and administrator 
functions. 

Annex A (Alternative SGL segment) describes the alternative SGL segment. 

Annex B (Operating system suggestions) describes operating system suggestions for the power actions. 
Annex C (SGL examples) describes SGL examples. 

Annex D (PQI host initialization and shut down sequence) describes the PQI host sequence for initialization 

and PQI host sequence for shut down. 


xiv 
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Figure 0 shows a layered view of the clauses of this standard. 



Figure 0 — Layered view of the clauses in this standard 
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AMERICAN NATIONAL STANDARD 


BSR INCITS 507-20xx 


American National Standard 
for Information Technology - 

PCI Express® Queuing Interface - 2 (PQI-2) 

1 Scope 

The SCSI family of standards provides for different transport protocols that define the methods for exchanging 
information between SCSI devices. This standard defines the transport methods for exchanging information 
between SCSI devices using a PCI Express interconnect. This standard defines a queuing layer, used by SOP. 
Other SCSI transport protocol standards define the methods for exchanging information between SCSI devices 
using other interconnects. Figure 1 shows the relationship of this standard to the other standards and related 
projects in the SCSI family of standards. 
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Figure 1 — SCSI document relationships 

PCI Express is used as the interconnect for this standard. This standard defines a generic queuing model to 
allow transporting lUs. 
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2 Normative references 


2.1 Normative references overview 

Referenced standards and specifications contain provisions that, by reference in the text, constitute provisions of 
this standard. At the time of publication, the editions indicated were valid. All standards are subject to revision, 
and parties to agreements based on this standard are encouraged to investigate the possibility of applying the 
most recent editions of the standards listed below. 

Copies of the following documents may be obtained from ANSI: 

a) approved ANSI standards; 

b) approved and draft international and regional standards (ISO, IEC, CEN/ELEC, ITU-T); and 

c) approved and draft foreign standards (including BSI, JIS, and DIN). 

For further information, contact ANSI Customer Service Department at 212-642-4980 (phone), 212-302-1286 
(fax) or via the World Wide Web at http://www.ansi.org. 

Additional availability contact information is provided below as needed. 


2.2 References under development 

At the time of publication, the following referenced standards were still under development. For information on 
the current status of a document, or regarding availability, contact the relevant standards body or other 
organization as indicated. 

ISO/I EC 14776-415, SCSI Architecture Model - 5 (SAM-5) (T10/BSR INCITS 515) 

ISO/IEC 14776-454, SCSI Primary Commands - 4 (SPC-4) (T10/BSR INCITS 513) 

ISO/I EC 14776-271, SCSI Over PCI Express® (SOP) (T10/BSR INCITS 489) 

NOTE 1 - For more information on the current status of these documents, contact the INCITS Secretariat at 
202-737-8888 (phone), 202-638-4922 (fax) or via Email at incits@itic.org. To obtain copies of these documents, 
contact Global Engineering at 15 Inverness Way, East Englewood, CO 80112-5704 at 303-792-2181 (phone), 
800-854-7179 (phone), or 303-792-2192 (fax) or see http://www.incits.org. 


2.3 Other references 

For information on the current status of a document, or regarding availability, contact the indicated organization. 

PCI Local Bus Specification Revision 3.0 (PCI), 3 February 2004 

PCI Express® Base Specification Revision 3.0 (PCIe), 10 November 2010 

PCI Code and ID Assignment Specification (PCI-ID) Revision 1.3, 4 September 2012 

PCI Bus Power Management Interface Specification (PCI-PM) revision 1.2, 3 March 2004 

PCI Express Card Electromechanical Specification (PCIe-CEM) revision 3.0, version 0.9, 23 May 2011 

NOTE 2 - For information on the current status of PCI documents, contact the PCI-SIG (see http:// 
www.pcisig.com). 

Advanced Configuration and Power Interface Specification (ACPI). Revision 5.0, 6 December 2011 

NOTE 3 - For information on the current status of ACPI documents, contact the ACPI Promoters (see http:// 
www.acpi.info). 
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3 Definitions, symbols, abbreviations, and conventions 


3.1 Definitions 

3.1.1 arbitration burst 

group of elements that may be consumed at one time from an IQ that is using round robin arbitration or weighted 

round robin arbitration 

3.1.2 arbitration set 

set of one or more IQs that share the same arbiter (see 5.3.5t 

3.1.3 administrator function (see 10.2) 

unit of work to be performed by a PQI device management device server 

3.1.4 administrator queue pair 

administrator IQ (see 5.2.5.8) and administrator OQ (see 5.2.5.11) 

3.1.5 aggregation (see 3.9.4) 

when used in class diagrams, form of association that defines a whole-part relationship between the whole (i.e., 
aggregate) and its parts 

3.1.6 alternative SGL segment (see annex A) 

data structure in a contiguous region of memory space describing all or part of a data buffer 

3.1.7 association 

when used in class diagrams, relationship between two or more classes that specifies connections among their 
objects (i.e., relationship that specifies that objects of one class are connected to objects of another class) 

3.1.8 attribute 

when used in class diagrams, named property of a class that describes a range of values that the class or its 
objects may hold; when used in object diagrams, named property of an instance of a class 

3.1.9 big-endian (see 3.7) 

format for binary data in which the most significant byte is first 

3.1.10 byte 

sequence of eight contiguous bits considered as a unit 

3.1.11 circular queue (see 5.3.2) 

data structure with an element array, consumer index, and producer index, that is used as if the first element 
follows the last element 

3.1.12 configuration space (see PCI and PCIe) 

byte addressable physical address space defined by PCI used to access registers of PCI functions (see PCI), 
addressed using ID-based routing (i.e., bus number, device number, if any, and function number), and accessible 
with configuration transactions 

3.1.13 configuration transaction (see PCIe) 

Request (see PCIe) and Completion (see PCIe) used to access configuration space 

3.1.14 consume 

read the content of the occupied element in a circular queue indicated by the circular queue’s Cl working copy 
and then increment the Cl working copy 
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3.1.15 consumer 

entity that consumes one or more elements from a circular queue 

3.1.16 consumer index (Cl) (see 5.2.5.6) 

index of a circular queue element array that points to the next element to be read by the consumer 

3.1.17 constraint 

when used in class diagrams and object diagrams, mechanism for specifying semantics or conditions that are 
maintained as true between entities (e.g., a required condition between associations) 

3.1.18 class 

description of a set of objects that share the same attributes, operations, relationships, and semantics; classes 
may have attributes and may support operations 

3.1.19 data block 

contiguous region of memory space 

3.1.20 data buffer 

one or more data blocks 

3.1.21 Data Buffer 

Data-In Buffer or Data-Out Buffer 

3.1.22 Data-In Buffer 

buffer specified by a PQI host management application client to receive data from a PQI device management 
device server 

3.1.23 Data-Out Buffer 

buffer specified by a PQI host management application client to supply data that is transferred to a PQI device 
management device server 

3.1.24 dequeue 

read an IU from a circular queue by consuming all elements within a circular queue that contain portions of that 
single IU 

3.1.25 destination data stream 

data that is being written to the PQI device 

3.1.26 dword 

sequence of four contiguous bytes considered as a unit 

3.1.27 element 

set of contiguous bytes in memory space that are part of a circular queue 

3.1.28 element array (see 5.2.5.3) 
set of contiguous elements 

3.1.29 element array address 

address of the start of the first element in the element array 

3.1.30 enqueue 

write an IU to a circular queue by producing sufficient elements to contain the content of the IU 

3.1.31 error code 

combination of the error code field (see 5.6) and the error code qualifier field (see 5.6) 
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3.1.32 field 

group of one or more contiguous bits that are part of a larger structure such as an IU 

3.1.33 frozen 

condition where queue elements are not being consumed as the result of a request by the PQI host 

3.1.34 generalization 

when used in class diagrams, relationship among classes where one class (i.e., superclass) shares the attributes 
and/or operations of one or more classes (i.e., subclasses) 

3.1.35 inbound IU 

IU contained in an IQ 

3.1.36 inbound queue (IQ) (see 5.2.5.7) 

circular queue that is used to transfer lUs from a PQI host to a PQI device 

3.1.37 information unit (IU) (see 9.2) 

delimited and sequenced set of information in a format appropriate for transport by the service delivery 
subsystem 

3.1.38 interrupt coalescing (see 5.4.2) 
technique for reducing the number of interrupts 

3.1.39 IQ ID (see 5.1) 
identifier assigned to an IQ 

3.1.40 least significant bit (LSB) 

in a binary code, bit or bit position with the smallest numerical weighting in a group of bits that, when taken as a 
whole, represent a numerical value (e.g., in the number 0001b, the bit that is set to one) 

3.1.41 legacy INTx (see PCI and PCIe) 

interrupt mechanism defined by PCI and supported by PCI Express using virtual INTx wires 

3.1.42 little-endian (see 3.7) 

format for binary data in which the least significant byte is first 

3.1.43 memory read transaction (see PCIe) 
memory transaction used to read from memory space 

3.1.44 memory space (see PCI and PCIe) 

64-bit byte addressable physical address space defined by PCI, addressed using address based routing (i.e., a 
64-bit address), and accessible with memory transactions 

3.1.45 memory transaction (see PCIe) 

Request (see PCIe) and one or more Completions (see PCIe) used to access memory space 

3.1.46 memory write transaction (see PCIe) 
memory transaction used to write to memory space 

3.1.47 most significant bit (MSB) 

in a binary code, bit or bit position with the largest numerical weighting in a group of bits that, when taken as a 
whole, represent a numerical value (e.g., in the number 1000b, the bit that is set to one) 

3.1.48 MSI-X Table (see PCI and PCIe) 

structure containing MSI-X vector control, message address, and message data registers 
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3.1.49 MSI-XPBA (see PCI) 
structure containing MSI-X pending bits 

3.1.50 multiplicity 

when used in class diagrams, indication of the range of allowable instances that a class or an attribute may have 

3.1.51 non-data administrator function 

administrator function that does not transfer data 

3.1.52 object 

entity with a well defined boundary and identity that encapsulates state and behavior; all objects are instances of 
classes (i.e., a concrete manifestation of a class is an object) 

3.1.53 occupied element 

element that contains valid data 

3.1.54 operation 

when used in class diagrams, service that may be requested from any object of the class in order to effect 
behavior 

3.1.55 OQ ID (see 5.1) 
identifier assigned to an OQ 

3.1.56 outbound III 

IU contained in an OQ 

3.1.57 outbound queue (OQ) (see 5.2.5.10) 

circular queue that is used to transfer lUs from a PQI device to a PQI host 

3.1.58 PCI Express device (see PCIe) 

collection of one or more PCI functions identified by a common bus number (see PCIe) and common device 
number (see PCIe), if any 

3.1.59 PCI Express hierarchy domain (see PCIe) 

the part of an I/O system (e.g., PCI Express switches and PCI Express links) that allows a PQI host and a PQI 
device to communicate 

3.1.60 PCI Express host (see PCIe) 

device containing a Root Complex Component (see PCIe) that connects to a host CPU (see PCI) 

3.1.61 PCI Express reset (see PCIe) 

PCI Express cold reset (see PCIe), PCI Express function-level reset (see PCIe), PCI Express hard reset (see 
PCIe), PCI Express hot reset (see PCIe), PCI Express soft reset (see PCIe), or PCI Express warm reset (see 
PCIe) 

3.1.62 PD function 

unit of work to be performed by a PQI device that is specified in the Administrator Queue Configuration Function 
register (see 6.2.5) 

3.1.63 PQI reset (see 5.7) 

PQI soft reset (see 5.7.2), PQI firm reset (see 5.7.3), or PQI hard reset (see 5.7.4) 

3.1.64 PQI device (see 5.2.3) 

kind of PCI function (see PCI) that is compliant with this standard 
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3.1.65 PQI device memory space 

memory space (see 3.1.44) in a PQI device whose address is specified in the first memory BAR in the PQI 
device’s configuration space 

3.1.66 PQI domain (see 5.2.1) 

one or more PQI hosts, one or more PQI devices, and the PQI service delivery subsystem through which they 
communicate 

3.1.67 PQI host (see 5.2.2) 

kind of PCI Express host or PCI Express device that communicates with a PQI device 

3.1.68 PQI host management application client (see 5.2.2.3) 

object in a PQI host that requests management tasks to be performed by PQI device management device 
servers 

3.1.69 PQI device management device server (see 5.2.3.4) 

object in a PQI device that performs management tasks requested by PQI host management application clients 

3.1.70 produce 

write content to the vacant element in the circular queue indicated by the circular queue’s PI working copy and 
then increment the PI working copy 

3.1.71 producer 

entity that produces one or more elements to a circular queue 

3.1.72 producer index (PI) (see 5.2.5.5) 

index of a circular queue’s element array where the new entries are written by the producer 

3.1.73 PCI Express Queuing Interface (PQI) 

queuing layer defined by this standard 

3.1.74 PCI memory BAR (see PCI) 

BAR (see PCI) that describes a region of memory space 

3.1.75 read administrator function 

administrator function for which a PQI device management device server transfers data to a PQI host 
management application client using a Data-In Buffer 

3.1.76 role 

when used in class diagrams and object diagrams, label at the end of an association or aggregation that defines 
a relationship to the class on the other side of the association or aggregation 

3.1.77 scatter gather list (SGL) (see clause 8) 
data structure used to describe a data buffer 

3.1.78 SGL segment 

standard SGL segment or alternative SGL segment 

3.1.79 source data stream 

data that is being read from the PQI device 

3.1.80 standard SGL segment (see 8.2) 

data structure in a contiguous region of memory space describing all or part of a data buffer and the next SGL 
segment, if any 

3.1.81 vacant element 

element that does not contain valid data 
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3.1.82 virtual INTx wire (see PCIe) 

virtual wire controlled by PCI Express Assert INTx and Deassert INTx Messages for emulation of legacy INTx 
interrupts 

3.1.83 write administrator function 

administrator function for which a PQI device management device server transfers data from a PQI host 
management application client using a Data-Out Buffer 


3.2 Symbols and abbreviations 


Units and abbreviations used in this standard: 


I 


Abbreviation Meaning 

+ add 

subtract 

< or LT less than 

= or EQ equal 

> or GT greater than 

> or GE greater than or equal to 

ACPI Advanced Configuration and Power Interface (see 2.3) 

AW arbitration weight (see 5.3.5.1) 

ARI Alternative Routing-ID Interpretation (see PCIe) 

B byte 

BAR base address register (see PCI) 

Cl consumer index (see 3.1.16) 

ID identifier 

INTx interrupt A, B, C, or D (see PCI) 

IQ inbound queue (see 3.1.36) 

IU information unit (see 3.1.37) 

LUN logical unit number 

LSB least significant bit (see 3.1.40) 

ms millisecond (i.e., 10' 3 seconds) 

MSB most significant bit (see 3.1.47) 

MSI-X Message Signaled Interrupt Extended (see PCI) 

ns nanosecond (i.e., 10" 9 seconds) 

OQ outbound queue (see 3.1.57) 

PBA Pending Bit Array (see 3.1.49 and PCI) 

PCI Peripheral Component Interconnect (see 2.3) 

PCIe PCI Express® Base Specification (see 2.3) 

PD PQI device state machine (see 5.5) 

PI producer index (see 3.1.72) 

POST power on self test 

PQI PCI Express Queuing Interface (i.e., this standard) 
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SAM-5 

SGL 

SOP 

SPC-4 


SCSI Architecture Model-5 (see 2.2) 
scatter gather list (see 3.1.77) 

SCSI over PCI Express® (see 2.2) 
SCSI Primary Commands-4 (see 2.2) 


3.3 Keywords 

3.3.1 invalid 

keyword used to describe an illegal or unsupported bit, byte, word, field or code value; receipt of an invalid bit, 
byte, word, field or code value shall be reported as an error 

3.3.2 mandatory 

keyword indicating an item that is required to be implemented as defined in this standard 

3.3.3 may 

keyword that indicates flexibility of choice with no implied preference (equivalent to “may or may not”) 

3.3.4 may not 

keywords that indicate flexibility of choice with no implied preference (equivalent to “may or may not”) 

3.3.5 obsolete 

keyword indicating that an item was defined in prior standards but has been removed from this standard 

3.3.6 optional 

keyword that describes features that are not required to be implemented by this standard; however, if any 
optional feature defined in this standard is implemented, then it shall be implemented as defined in this standard 

3.3.7 reserved 

keyword referring to bits, bytes, words, fields and code values that are set aside for future standardization; a 
reserved bit, byte, word or field shall be set to zero, or in accordance with a future extension to this standard; 
recipients are not required to check reserved bits, bytes, words or fields for zero values; receipt of reserved code 
values in defined fields shall be reported as an error 

3.3.8 RsvdC 

keyword referring to bits, bytes, or fields that are set aside for future standardization that shall be set to zero or in 
accordance with a future extension to this standard, and shall be checked for zero values by the recipient 

3.3.9 RsvdZ 

keyword referring to bit, byte, or field in a PQI device for future standardization that should be set to zero by the 
PQI host during memory writes, shall be ignored by the PQI device during memory writes, and shall be set to 
zero by the PQI device during memory reads 

3.3.10 restricted 

keyword referring to bits, bytes, words, and fields that are set aside for other identified standardization purposes; 
a restricted bit, byte, word, or field shall be treated as a reserved bit, byte, word or field in the context where the 
restricted designation appears 

3.3.11 shall 

keyword indicating a mandatory requirement; designers are required to implement all such mandatory 
requirements to ensure interoperability with other products that conform to this standard 

3.3.12 should 

keyword indicating flexibility of choice with a strongly preferred alternative (equivalent to “is strongly 
recommended”) 
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3.3.13 vendor specific 

something (e.g., a bit, field, or code value) that is not defined by this standard and may be used differently in 
various implementations 


3.4 Editorial conventions 

Certain words and terms used in this standard have a specific meaning beyond the normal English meaning. 
These words and terms are defined either in the glossary or in the text where they first appear. 

Upper case is used when referring to the name of a numeric value defined in this specification or a formal 
attribute possessed by an entity. When necessary for clarity, names of objects, procedure calls, arguments or 
discrete states are capitalized or set in bold type. Names of fields are identified using small capital letters (e.g., 

NACA bit). 

Names of procedure calls are identified by a name in bold type (e.g., Execute Command). Names of arguments 
are denoted by capitalizing each word in the name (e.g., Sense Data is the name of an argument in the Execute 
Command procedure call). For more information on procedure calls see 3.8. 

Quantities having a defined numeric value are identified by large capital letters (e.g., CHECK CONDITION). 
Quantities having a discrete but unspecified value are identified using small capital letters, (e.g., task complete, 
indicates a quantity returned by the Execute Command procedure call). Such quantities are associated with an 
event or indication whose observable behavior or value is specific to a given implementation standard. 

Lists sequenced by lowercase or uppercase letters show no ordering relationship between the listed items. 

EXAMPLE 1 - The following list shows no relationship between the named items: 

a) red (i.e., one of the following colors): 

A) crimson: or 

B) amber; 

b) blue; or 

c) green. 

Lists sequenced by numbers show an ordering relationship between the listed items. 

EXAMPLE 2 -The following list shows an ordered relationship between the named items: 

1) top; 

2) middle; and 

3) bottom. 

If a conflict arises between text, tables, or figures, the order of precedence to resolve the conflicts is text; then 
tables; and finally figures. Not all tables or figures are fully described in the text. Tables show data format and 
values. 

Notes and examples do not constitute any requirements for implementors and notes are numbered consecutively 
throughout this standard. 


3.5 Numeric and character conventions 

3.5.1 Numeric conventions 

A binary number is represented in this standard by any sequence of digits comprised of only the Arabic numerals 
0 and 1 immediately followed by a lower-case b (e.g., 0101b). Underscores or spaces may be included in binary 
number representations to increase readability or delineate field boundaries (e.g., 0 0101 1010b or 
0_01011010b). 
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A hexadecimal number is represented in this standard by any sequence of digits comprised of only the Arabic 
numerals 0 through 9 and/or the upper-case English letters A through F immediately followed by a lower-case h 
(e.g., FA23h). Underscores or spaces may be included in hexadecimal number representations to increase 
readability or delineate field boundaries (e.g., B FD8C FA23h or B_FD8C_FA23h). 

A decimal number is represented in this standard by any sequence of digits comprised of only the Arabic 
numerals 0 through 9 not immediately followed by a lower-case b or lower-case h (e.g., 25). 

A range of numeric values is represented in this standard in the form “a to z”, where a is the first value included 
in the range, all values between a and z are included in the range, and z is the last value included in the range 
(e.g., the representation “Oh to 3h” includes the values Oh, 1 h, 2h, and 3h). 

This standard uses the following conventions for representing decimal numbers: 

a) the decimal separator (i.e., separating the integer and fractional portions of the number) is a period; 

b) the thousands separator (i.e., separating groups of three digits in a portion of the number) is a space; 

c) the thousands separator is used in both the integer portion and the fraction portion of a number; and 

d) the decimal representation for a year is 1999 not 1 999. 

Table 1 shows some examples of decimal numbers using various conventions. 


Table 1 — Numbering conventions 


French 

English 

This standard 

0,6 

0.6 

0.6 

3,141 592 65 

3.14159265 

3.141 592 65 

1 000 

1,000 

1 000 

1 323 462,95 

1,323,462.95 

1 323 462.95 


3.5.2 Units of measure 

This standard represents values using both decimal units of measure and binary units of measure. Values are 
represented by the following formats: 

a) for values based on decimal units of measure: 

1) numerical value (e.g., 100); 

2) space; 

3) prefix symbol and unit: 

1) decimal prefix symbol (e.g., M) (see table 2); and 

2) unit abbreviation (e.g., B); 


b) for values based on binary units of measure: 

1) numerical value (e.g., 1 024); 

2) space; 

3) prefix symbol and unit: 

1) binary prefix symbol (e.g., Gi) (see table 2); and 

2) unit abbreviation (e.g., b). 
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Table 2 compares the prefix, symbols, and power of the binary and decimal units. 


Table 2 — Comparison of decimal prefixes and binary prefixes 


Decimal 

Binary 

Prefix name 

Prefix symbol 

Power 

(base-10) 

Prefix name 

Prefix symbol 

Power 

(base-2) 

kilo 

k 

10 3 

kibi 

Ki 

2 io 

mega 

M 

10 6 

mebi 

Mi 

2 20 

giga 

G 

10 9 

gibi 

Gi 

2 30 

tera 

T 

10 12 

tebi 

Ti 

2 40 

peta 

P 

10 15 

pebi 

Pi 

2 50 

exa 

E 

10 18 

exbi 

Ei 

2 60 

zetta 

Z 

10 21 

zebi 

Zi 

2 70 

yotta 

Y 

10 24 

yobi 

Yi 

2 80 


3.5.3 Byte encoded character strings conventions 


When this standard requires one or more bytes to contain specific encoded characters, the specific characters 
are enclosed in single quotation marks. The single quotation marks identify the start and end of the characters 
that are required to be encoded but are not themselves to be encoded. The characters that are to be encoded 
are shown in the case that is to be encoded. 

An ASCII space character (i.e., 20h) may be represented in a string by the character (e.g., ‘SCShdevice’). 

The encoded characters and the single quotation marks that enclose them are preceded by text that specifies 
the character encoding methodology and the number of characters required to be encoded. 

EXAMPLE - Using the notation described in this subclause, stating that eleven ASCII characters ‘SCSI device’ are encoded 
to the following sequence of byte values: 53h 43h 53h 49h 20h 64h 65h 76h 69h 63h 65h. 
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3.6 State machine conventions 

3.6.1 State machine conventions overview 

Figure 2 shows how state machines are described. 


State machine name 

State designator:State_Name State designator:State_Name 

(from upper layer) 


\ „ Request name or 
response name " " "* 

State -Transition condition* 
designator 


State 

machine 

name —Message name ^ 
or state 


—Transition Condition- 


Transition condition 


■ “ "Message name 


State 
machine | 
name 

.Message name pTsfafe I 
designator! 

■Transition condition h 


Request name or 
' response name 


designator ] 

(to lower layer)^ 

(different) State machine name ■ 

■ 

_ Message name. 

State designator:State_Name \ State designator:State_Name 

Confirmation name, 
indication name, or 
event notification name 

(from lower layer) 

-Message name - 

(from transmitter or 
receiver) 


(to upper layer) 

4 

Confirmation name, 

. _ .indication name, or 
event notification name 

-Message name- 

(to transmitter or 
receiver) 




Figure 2 — State machine conventions 

When multiple state machines are present in a figure, they are enclosed in boxes with rounded corners. 

Each state is identified by a state designator and a state name. The state designator (e.g., SL1) is unique among 
all state machines in this standard. The state name (e.g., Idle) is a brief description of the primary action taken 
during the state, and the same state name may be used by other state machines. Actions taken while in each 
state are described in the state description text. 

3.6.2 Transitions 

Transitions between states are shown with solid lines, with an arrow pointing to the destination state. A transition 
may be labeled with a transition condition label, a brief description of the event or condition that causes the 
transition to occur. 
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If the state transition leaves the page, the transition label goes to or from a state designator label with double 
underlines rather than to or from a state. 

The conditions and actions are described fully in the transition description text. In case of a conflict between a 
figure and the text, the text shall take precedence. 

Upon entry into a state, all actions to be processed in that state are processed. If a state is re-entered from itself, 
all actions to be processed in the state are processed again. A state may be entered and exited in zero time if the 
conditions for exiting the state are valid upon entry into the state. Transitions between states are instantaneous. 

3.6.3 Messages, requests, indications, confirmations, responses, and event notifications 

Messages passed between state machines are shown with dashed lines labeled with a message name. When 
messages are passed between state machines within the same layer of the protocol, they are identified by either: 

a) a dashed line to or from a state machine name label with double underlines and/or state name label with 
double underlines, if the destination is in a different figure from the source; 

b) a dashed line to or from a state in another state machine in the same figure; or 

c) a dashed line from a state machine name label with double underlines to a “(to all states)” label, if the 
destination is every state in the state machine. 

The meaning of each message is described in the state description text. 

Requests, indications, confirmations, responses, and event notifications are shown with curved dashed lines 
originating from or going to the top or bottom of the figure. Each request, indication, confirmation, response, and 
event notification is labeled. The meaning of each request, indication, confirmation, response, and event 
notification is described in the state description text. 

Messages with unfilled arrowheads are passed to or from the state machine’s transmitter or receiver, not shown 
in the state machine figures, and are directly related to data being transmitted on or received from the physical 
link. 

3.6.4 State machine counters, timers, and variables 

State machines may contain counters, timers, and variables that affect the operation of the state machine. The 
scope of state machine counters, timers, and variables is the state machine itself. They are created and deleted 
with the state machines with which they are associated. State machine transitions specify the initialization and 
modification of state machine timers, counters, and variables. Transitions out of a state may be conditioned upon 
specific criteria regarding the current value of a state machine counter, timer, or variable. State machine timers 
may continue to run while a state machine is in a given state, and a timer may cause a state transition upon 
reaching a defined threshold value (e.g., zero for a timer that counts down). 

3.6.5 State machine arguments 

State machines may contain one or more arguments received in a message or confirmation as state machine 
arguments. The following properties apply to state machine arguments: 

a) the state machine that sends an argument owns that argument’s value; 

b) the state machine that receives an argument shall not modify that argument’s value; 

c) the state machine that sends an argument may resend that argument with a different value; 

d) the scope of a state machine argument is the state machine itself; and 

e) state machine argument usage is described in the state descriptions and the transition descriptions. 


3.7 Bit and byte ordering 

In this standard, data structures may be defined by a table. A table defines a complete ordering of elements (i.e., 
bits, bytes, fields, and dwords) within the structure. The ordering of elements within a table does not in itself 
constrain the order of storage or transmission of the data structure, but in combination with other normative text 
in this standard, may constrain the order of storage or transmission of the structure. 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 


14 



| T10/BSRINCITS 507 Revision 01 


16 April 2015 


Tables defining data structures are shown with one row per byte and one column per bit. The lowest byte offset is 
at the top and the highest byte offset is at the bottom. The least significant bit (LSB) of each byte is numbered 0 
and is shown on the right, and the most significant bit (MSB) of each byte is numbered 7 and shown on the left. 

In a field in a table consisting of more than one bit that contains a single value (e.g., a number), the least 
significant bit (LSB) is shown on the right and the most significant bit (MSB) is shown on the left (e.g., in a byte, 
bit 7 is the MSB and is shown on the left, bit 0 is the LSB and is shown on the right). The MSB and LSB are not 
labeled if the field consists of eight or fewer bits and is contained within one row. The MSB and LSB are labeled 
if the field consists of more than eight bits, crosses a row, and has no internal structure defined. 

In a big-endian field, the byte containing the MSB is at the lowest byte offset and the byte containing the LSB is 
at the highest byte offset. The bits in big-endian fields are not shaded. 

In a little-endian field, the byte containing the MSB is at the highest byte offset and the byte containing the LSB is 
at the lowest byte offset. The bits in little-endian fields are shaded. 

In a field in a table consisting of more than one byte that contains multiple fields each with their own values (e.g., 
a descriptor), there is no MSB and LSB of the field itself and thus there are no MSB and LSB labels for that field. 
The MSB and LSB of each subfield may be shown in another table. 

In a field containing a text string (e.g., ASCII or UTF-8), only the MSB of the first character and the LSB of the last 
character are labeled. 

Multiple byte fields are represented with three rows, with the non-sequentially increasing byte numbers 
separated by a row labeled 

Table 3 shows how this standard depicts a 32-bit big-endian field. 


Table 3 — Example of a 32-bit big-endian field 


Byte\Bit 

7 6 5 4 3 2 1 ° 


Other fields, if any 

n 

(MSB) 


Field name 

n + 3 

(LSB) 


Other fields, if any 


Table 4 shows the bit numbers for the field shown in table 3. 

Table 4 — Bit assignments in a 32-bit big-endian field 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

° 

... 

Other fields, if any 

n 

(MSB) 

Bit 31 

Bit 30 

Bit 29 

Bit 28 

Bit 27 

Bit 26 

Bit 25 

Bit 24 

n + 1 

Bit 23 

Bit 22 

Bit 21 

Bit 20 

Bit 19 

Bit 18 

Bit 17 

Bit 16 

n + 2 

Bit 15 

Bit 14 

Bit 13 

Bit 12 

Bit 11 

Bit 10 

Bit 9 

Bit 8 

n + 3 

Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

BitO 

(LSB) 

... 

Other fields, if any 


EXAMPLE 1 - If the field in table 3 and table 4 contains a value of 00010203h, then: 

a) byte n contains OOh; 

b) byte n+1 contains 01 h; 

c) byte n+2 contains 02h; and 
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d) byte n+3 contains 03h. 

Table 5 shows how this standard depicts a 32-bit little-endian field. 

Table 5 — Example of a 32-bit little-endian field 


Byte\Bit 

7 6 5 4 3 2 1 ° 


Other fields, if any 

n 

(LSB) 


Field name 

n + 3 

(MSB) 


Other fields, if any 


Table 6 shows the bit numbers for the field shown in table 5. 


Table 6 — Bit numbers for a 32-bit little-endian field 


Byte\Bit 


6 

5 

4 

3 

2 


0 


Other fields, if any 

n 

Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

(LSB) 

BitO 

n + 1 

Bit 15 

Bit 14 

Bit 13 

Bit 12 

Bit 11 

Bit 10 

Bit 9 

Bit 8 

n + 2 

Bit 23 

Bit 22 

Bit 21 

Bit 20 

Bit 19 

Bit 18 

Bit 17 

Bit 16 

n + 3 

Bit 31 
(MSB) 

Bit 30 

Bit 29 

Bit 28 

Bit 27 

Bit 26 

Bit 25 

Bit 24 


Other fields, if any 


EXAMPLE 2 - If the field in table 5 and table 6 contains a value of 00010203h, then: 

a) byte n contains 03h; 

b) byte n+1 contains 02h; 

c) byte n+2 contains 01 h; and 

d) byte n+3 contains OOh. 


3.8 Notation for procedure calls 

In this standard, the model for functional interfaces between entities is a procedure call. Such interfaces are 
specified using the following notation: 

[Result =] Procedure Name (IN ([input-1] [,input-2] ...), OUT ([output-1] [,output-2] ...)) 
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Where: 


A single value representing the outcome of the procedure or 
function. 

A descriptive name for the function to be performed. 

A comma-separated list of names identifying caller-supplied input 
data objects. 

A comma-separated list of names identifying output data objects to 
be returned by the procedure. 

Brackets enclose optional or conditional parameters and arguments. 

This notation allows arguments to be specified as inputs and outputs. An interface between entities may require 
only inputs. If a procedure call has no output arguments, the word OUT, preceding comma, and associated pair 
of balanced parentheses are omitted. 

The following is an example of a procedure call specification: 


Result 

Procedure Name 
IN (Input-1, Input-2, ...) 

OUT (Output-1, Output-2, ...) 
[...] 


Found = Search (IN (Pattern, Item List), OUT ([Item Found])) 


Input arguments: 


Pattern: Argument containing the search pattern. 

Item List: ltem<NN> contains the items to be searched for a match. 


Output arguments: 

Item Found: Item located by the search procedure call. This argument is only returned if the 
search succeeds. 


3.9 Notation for UML figures 

3.9.1 Introduction 

This standard contains class diagram figures that use notation that is based on UML. 
Some class diagrams contain constraints or notes that use the notion shown in table 7. 


Table 7 — Class diagram constraints and notes notation 


Notation 

Description 


{constraint text} 


The presence of the curly brackets defines constraint that 
is a normative requirement. An example of a constraint is 
shown in figure 4. 


K 

note text 


The absence of curly brackets defines a note that is infor¬ 
mative. An example of a note is shown in figure 5. 


17 


Working Draft PCI Express® Queuing Interface -2 



















| 16 April 2015 


T10/BSR INCUS 507 Revision 01 


The notation used to denote multiplicity in class diagrams is shown in table 8. 


Table 8 — Class diagram multiplicity notation 


Notation 

Description 

not specified 

The number of instances of an attribute is not specified. 

1 

One instance of the class or attribute exists. 

0..* 

Zero or more instances of the class or attribute exist. 

1..* 

One or more instances of the class or attribute exist. 

0..1 

Zero or one instance of the class or attribute exists. 

n..m 

n to m instances of the class or attribute exist (e.g., 2..8). 

x,n,,m 

Multiple disjoint instances of the class or attribute exist (e.g., 2, 8..15). 


Class diagrams show: 

a) two or more classes (see 3.9.2); and 

b) one or more of the following relationships between them: 

A) association (see 3.9.3); 

B) aggregation (see 3.9.4); 

C) generalization (see 3.9.5); and 

D) dependency (see 3.9.6). 

3.9.2 Class notation 


The notation used for classes is shown in table 9. 


Table 9 — Class diagram notation for classes (part 1 of 2) 


Class Name 


Notation 


Description 


Class Name 


Class Name 







A class with no attributes or operations 


Class Name 


Class Name 

Attributed [1] 
Attribute02[1] 


AttributeOI [1] 
Attribute02[1] 




A class with attributes and no operations 


Class Name 


Operation01() 

Operation02() 


A class with operations and no attributes 
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Table 9 — Class diagram notation for classes (part 2 of 2) 


Notation 

Description 


Class Name 

Attributed [1] 
Attribute02[1] 

Operation01() 

Operation02() 


A class with attributes and operations 


Class Name 

Attributed [1..*] 
Attribute02[1] 

Operation01() 

Operation02() 


A class with attributes that have a 
specified multiplicity (see table 8) and 
operations 


3.9.3 Class association relationships notation 

The notation used to denote association (i.e., “knows about”) relationships between classes is shown in table 10. 
Unless the two classes in an association relationship also have an aggregation relationship (see 3.9.4), 
association relationships have multiplicity notation (see table 8) at each end of the relationship line. 


Table 10 — Class diagram notation for associations 


Notation 

Description 

i— —- - — | . association name . r- — - —, 

Class A Class B 

^1-* 0..1x^ 

^multiplicity notation (see table 8)^ 

Class A knows about Class B (i.e., read as "Class 

A association name Class B") and Class B knows 
about Class A (i.e., read as "Class B association 
name Class A") 

Class A |<; - Class B 

- i o..i - 

Class B knows about Class A (i.e., read as "Class 

B knows about Class A") but Class A does not 
know about Class B 

Class A -—- ^ Class B 

- o..* o..i - 

Class A knows about Class B (i.e., read as "Class 

A uses the role name attribute of Class B") but 
Class B does not know about Class A 

Note: The use of role names and association names are optional. 
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Several example association relationships between classes are shown in figure 3. 



Figure 3 — Example class association relationships 


3.9.4 Class aggregation relationships notation 

The aggregation relationship is a specific type of association. The notation used to denote aggregation (i.e., “is a 
part of” or “contains”) relationships between classes is shown in table 11. Aggregation relationships always 
include multiplicity notation (see table 8) at each end of the relationship line. 


Table 11 — Class diagram notation for aggregations 


Notation 

Description 

P|BjEjIO - 1 Part 

- o..* o..* - 

^multiplicity notation (see table 8) 

The Part class is part of the Whole class and may 
continue to exist even if the Whole class is removed 
(i.e., read as "the Whole contains the Part.") 

1 Whole J J Part 1 

- i o..* - 

The Part class is part of the Whole class, shall only 
belong to one Whole class, and shall not continue 
to exist if the Whole class is removed (i.e., read as 
"the Whole contains the Part.") 
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Several example aggregation relationships between classes are shown in figure 4. 



Figure 4 — Example class aggregation relationships 
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3.9.5 Class generalization relationships notation 

The notation used to denote generalization (i.e., “is a kind of”) relationships between classes is shown in table 
12 . 


Table 12 — Class diagram notation for generalizations 


Notation 

Description 

Superclass - Subclass 

Subclass is a kind of superclass. A subclass shares 
all the attributes and operations of the superclass 
(i.e., the subclass inherits from the superclass). 


Several example generalization relationships between classes are shown in figure 5. 


Single superclass — single subclass Multiple superclasses — single subclass 



Figure 5 — Example class generalization relationships 
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3.9.6 Class dependency relationships notation 

The notation used to denote dependency (i.e., “depends on”) relationships between classes is shown in table 13. 


Table 13 — Class diagram notation for dependencies 


Notation 

Description 

Class A ->|p Class B 

Class A depends on class B. A change in class B 
may cause a change in class A. 


An example dependency relationship between classes is shown in figure 6. 


| Dependent | --^ |lndependent| 

Figure 6— Example class dependency relationships 

3.9.7 Object notation 

The notation used for objects is shown in table 14. 


Table 14 — Notation for objects 


Notation 

Description 


Notation for a named object with no attributes 


label : Class Name 

AttributeOI = x 
Attribute02 = y 


Notation for a named object with attributes 

: Class Name | 

Notation for an anonymous object with no attributes 


: Class Name 

AttributeOI = x 
Attribute02 = y 


Notation for an anonymous object with attributes 
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4 General concepts 

4.1 ASCII data field requirements 

ASCII data fields shall contain only ASCII printable characters (i.e., code values 20h to 7Eh) and may be 
terminated with one or more ASCII null (OOh) characters. 

ASCII data fields described as being left-aligned shall have any unused bytes at the end of the field (i.e., highest 
offset) and the unused bytes shall be filled with ASCII space characters (20h). 

ASCII data fields described as being right-aligned shall have any unused bytes at the start of the field (i.e., lowest 
offset) and the unused bytes shall be filled with ASCII space characters (20h). 
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5 Model 

5.1 General overview 

This standard defines: 

a) a method to manage (e.g., create, delete, and configure) circular queues; 

b) an interface for transferring information between a PQI host and a PQI device over a PQI service 
delivery subsystem in a PQI domain, using circular queues; and 

c) an SGL (see clause 8) format that is used to describe data buffers. 

Certain types of information (e.g., command/functions information and response information) are packaged into 
lUs and transferred using circular queues. Other types of information (e.g., data) are transferred using memory 
transactions. 

Information is transferred between a PQI host and a PQI device using one or more circular queues. A producer 
encapsulates the information into an IU and enqueues that IU to a circular queue. A consumer dequeues the IU 
from the circular queue and extracts the information from the IU. 

Each circular queue is unidirectional: 

a) an IQ is used to transfer lUs from the PQI host to the PQI device; and 

b) an OQ is used to transfer I Us from the PQI device to the PQI host. 

A PQI host provides: 

a) the PQI host management application client to perform management of the circular queues; and 

b) an interface to support the PQI host operational application client. 

A PQI device provides: 

a) the PQI device management device server to perform PQI management request functions requested by 
the PQI host management application client; and 

b) an interface to support the PQI operational device server. 

Figure 7 shows: 

a) a PQI host; 

b) a PQI device; and 

c) a PQI service delivery subsystem that contains a PQI domain with: 

A) IQs; and 

B) OQs. 
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PQI domain 



Figure 7 — PQI device, PQI host, PQI service delivery subsystem, IQs, and OQs 

This standard defines the following types of circular queues: 

a) administrator queues; and 

b) operational queues. 

Administrator queues are used by the PQI host management application client and the PQI device management 
device server to transfer administrator lUs that are used to manage the PQI domain. Only one administrator IQ 
and only one administrator OQ (i.e., an administrator queue pair) shall be present within a PQI domain. 

Operational queues are used by a PQI host operational application client interface and a PQI operational device 
server as specified by other IU layers (e.g., SOP) to transfer IU layer specific lUs. Multiple operational IQs and 
multiple operational OQs may be present within a PQI domain. The number of operational IQs may be greater 
than, less than, or equal to the number of operational OQs. 

The queuing model in this standard applies to both types of circular queues, although the methods of creating 
queues of the two types differ. 

Administrator lUs: 

a) are used for managing the PQI device and are defined in this standard (see clause 10); and 

b) are transferred between the PQI host management application client and the PQI device management 
device server using an administrator IQ or an administrator OQ. 

The administrator IQ and administrator OQ are created and configured using PQI device registers (see 6.2). 
Operational lUs: 

a) are defined in other standards (e.g., SOP); and 

b) are transferred using the PQI host operational application client interface and the PQI device operational 
device server interface through an operational IQ or an operational OQ. 

Operational IQs and OQs are created and configured by the PQI host management application client using 
administrator lUs (see 10.2). 

An IQ ID value is specified when an operational IQ is created and is used to identify that specific operational IQ. 
An OQ ID value is specified when an operational OQ is created and is used to identify that specific operational 
OQ. The values of the IQ IDs assigned to operational IQs are independent from the values of the OQ IDs 
assigned to operational OQs. 
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5.2 PQI classes 

5.2.1 PQI domain class 

Figure 8 describes the classes related to the PQI domain showing the relationships between the following 
classes: 

a) PQI Domain; 

b) PCI Express Hierarchy Domain; 

c) PQI Service Delivery Subsystem (see 5.2.4); 

d) PQI Device (see 5.2.3.2); and 

e) PQI Host (see 5.2.2.2). 


Classes for objects 



Figure 8 — PQI Domain class diagram 

Each instance of a PQI Domain class (see figure 8) shall contain the following: 

a) one or more instances of the PQI Host class (see 5.2.2); 

b) one or more instances of the PQI Device class (see 5.2.3); and 

c) one instance of the PQI Service Delivery Subsystem class (see 5.2.4). 

The PQI domain represents an instance of the PQI Domain class. 

5.2.2 PQI host classes 

5.2.2.1 PQI host classes overview 

Figure 9 describes the classes related to the PQI host, showing the relationship between the following classes: 

a) PCI Express Host (see PCIe); 

b) PCI Express Function (see PCIe); 

c) PQI Host (see 5.2.2.2); 

d) PQI Host Management Application Client (see 5.2.2.3); 

e) PQI Host Administrator OQ Information (see 5.2.2.4); 

f) PQI Host Administrator IQ Information (see 5.2.2.5); 

g) PQI Host Operational Application Client Interface (see 5.2.2.6); 

h) PQI Host Operational OQ Information (see 5.2.2.7); and 

i) PQI Host Operational IQ Information (see 5.2.2.8). 
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Classes for objects defined in PCIe 




PCI Express Host 


PCI Express Function 



Function Number[1] 


3= 


E 






PQI Host Management 
Application Client 


E 


{A PQI Host is a 
kind of PCI Express 
Host or a kind of 
PCI Express 
Function, but not 
both.} 


PQI Host Operational 
Application Client Interface 


Enqueue IU to IQ() 
Dequeue IU from OQ() 


PQI Host Administrator OQ 
Information 

OQ Element Array Address[1] 

OQ Element Length[1] 

OQ Number Of Elements[1] 

OQ PI Address[1] 

OQ PI Local Copy[0..1] 

OQ PI Working Copy[0..1] 

OQ Cl Address[1] 

OQ Cl Local Copy[1] 

OQ Cl Working Copy[1] _ 


0..1_ 

PQI Host Administrator IQ 
_ Information _ 

IQ Element Array Address[1] 

IQ Element Length[1] 

IQ Number Of Elements[1] 

IQ PI Address[1] 

IQ PI Local Copy[1] 

IQ PI Working Copy[1] 

IQ Cl Address[1] 

IQ Cl Local Copy[0..1] 

IQ Cl Working Copy[0..1] 


PQI Host Operational OQ 
Information 

OQ ID[1] 

OQ Element Array Address[1] 

OQ PI Address[1] 

OQ Cl Address[1] 

OQ Number Of Elements[1] 

OQ Element Length[1] 

OQ PI Local Copy[0..1] 

OQ PI Working Copy[0..1] 

OQ Cl Local Copy[1] 

OQ Cl Working Copy[1] 

OQ Minimum Coalescing Time[1] 
OQ Maximum Coalescing Time[1] 
OQ Coalescing Count[1] 

OQ Wait For Rearm[1] 

OQ Interrupt Message Number[1] 
OQ MSI-X Disable[1] 

OQ Spanning Allowed[1] 

OQ Operational Queue Protocol[1] 


0..65 535 _ 

PQI Host Operational IQ 
_ Information _ 

IQ ID[1] 

IQ Element Array Address[1] 

IQ Number Of Elements[1] 

IQ Element Length[1] 

IQ Spanning Allowed[1] 

IQ PI Address[1] 

IQ PI Local Copy[1] 

IQ PI Working Copy[1] 

IQ Cl Address[1] 

IQ Cl Local Copy[0..1] 

IQ Cl Working Copy[0..1] 

IQ Operational Queue Protocol[1] 

IQ Arbitration Priority[1] 


Figure 9 — PQI Host class diagram 
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5.2.2.2 PQI Host class 

The PQI Host class (see figure 9) is a kind of either PCI Express Host class or a kind of PCI Express Function 
class but not both, and contains the: 

a) PQI Host Management Application Client class (see 5.2.2.3); 

b) PQI Host Administrator OQ Information class (see 5.2.2.4); 

c) PQI Host Administrator IQ Information class (see 5.2.2.5); 

d) PQI Host Operational Application Client Interface class (see 5.2.2.6); 

e) PQI Host Operational OQ Information class (see 5.2.2.7); and 

f) PQI Host Operational IQ Information class (see 5.2.2.8). 

The PQI host represents an instance of the PQI Host class. 

5.2.2.3 PQI Host Management Application Client class 

The PQI Host Management Application Client class (see figure 9) requests administrator operations to be 
performed by a PQI device management device server. 

5.2.2.4 PQI Host Administrator OQ Information class 

The PQI host administrator OQ information represents an instance of the PQI Host Administrator OQ Information 
class (see figure 9). 

Each instance of the PQI Host Administrator OQ Information class (see figure 9) contains the following attributes 
that describe an instance of the Administrator OQ class (see 5.2.5.11 and figure 13): 

a) the OQ Element Array Address attribute, which contains the OQ element array address (see 5.2.5.11.4); 

b) the OQ Number Of Elements attribute, which contains the number of elements in the OQ (see 
5.2.5.11.6); 

c) the OQ Element Length attribute, which contains the length in bytes of the elements of the OQ (see 
5.2.5.11.5); 

d) the OQ PI Address attribute, which contains the OQ PI address (see 5.2.5.11.7); 

e) the OQ PI Local Copy attribute, if any, which contains the OQ PI local copy (see 5.3.2.3); 

f) the OQ PI Working Copy attribute, if any, which contains the OQ PI working copy (see 5.3.2.3); 

g) the OQ Cl Local Copy attribute, which contains the OQ Cl local copy (see 5.3.2.4); and 

h) the OQ Cl Working Copy attribute, which contains the OQ Cl working copy (see 5.3.2.4). 

5.2.2.5 PQI Host Administrator IQ Information class 

The PQI host administrator IQ information represents an instance of the PQI Host Administrator IQ Information 
class (see figure 9). 

Each instance of the PQI Host Administrator IQ Information class (see figure 9) contains the following attributes 
that describe an instance of the Administrator IQ class (see 5.2.5.8 and figure 13): 

a) the IQ Element Array Address attribute, which contains the IQ element array address (see 5.2.5.8.2); 

b) the IQ Number Of Elements attribute, which contains the number of elements in the IQ (see 5.2.5.8.4); 

c) the IQ Element Length attribute, which contains the length in bytes of the elements of the IQ (see 
5.2.5.8.3); 

d) the IQ PI Address attribute, which contains the IQ PI address (see 5.2.5.8.5); 

e) the IQ PI Local Copy attribute, which contains the IQ PI local copy (see 5.3.2.3); 

f) the IQ PI Working Copy attribute, which contains the IQ PI working copy (see 5.3.2.3); 

g) the IQ Cl Address attribute, which contains the IQ Cl address (see 5.2.5.8.6); 

h) the IQ Cl Local Copy attribute, if any, which contains the IQ Cl local copy (see 5.3.2.4); and 

i) the IQ Cl Working Copy attribute, if any, which contains the IQ Cl working copy (see 5.3.2.4). 
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5.2.2.6 PQI Host Operational Application Client Interface class 

The PQI Host Operational Application Client Interface class (see figure 9) provides services to the host queuing 
layer interface defined in the IU layer standard (e.g., SOP). The PQI Host Operational Application Client Interface 
provides: 

a) enqueuing of lUs compliant with clause 9 to operational IQs; 

b) dequeueing of lUs compliant with clause clause 9 from operational OQs; and 

c) generation of notifications of lUs on OQs available to be dequeued. 

The PQI Host Operational Application Client Interface class processes Enqueue To IQ() requests (see 5.3.2.5) 
and Dequeue From OQ() requests (see 5.3.2.6) from the host queuing layer interface defined in the IU layer 
standard (e.g., SOP). 

The PQI Host Operational Application Client Interface class provides IU Available On OQ operations to the host 
queuing layer interface defined in the IU layer standard (e.g., SOP). 

5.2.2.7 PQI Host Operational OQ Information class 

The PQI host operational OQ information represents an instance of the PQI Host Operational OQ Information 
class (see figure 9). 

Each instance of the PQI Host Operational OQ Information class (see figure 9) contains the following attributes 
that describe an instance of the Operational OQ class (see 5.2.5.12 and figure 13): 

a) the OQ ID attribute, which contains the OQ ID (see 5.2.5.12.2); 

b) the OQ Element Array Address attribute, which contains the OQ element array address (see 5.2.5.12.3); 

c) the OQ PI Address attribute, which contains the OQ PI address (see 5.2.5.12.6); 

d) the OQ Cl Address attribute, which contains the OQ Cl address (see 5.2.5.12.7); 

e) the OQ Number Of Elements attribute, which contains the number of elements in the OQ (see 
5.2.5.12.5); 

f) the OQ Element Length attribute which, contains the length in bytes of the elements of the OQ (see 
5.2.5.12.4); 

g) the OQ PI Local Copy attribute, if any, which contains the OQ PI local copy (see 5.3.2.3); 

h) the OQ PI Working Copy attribute, if any, which contains the OQ PI working copy (see 5.3.2.3); 

i) the OQ Cl Local Copy attribute, which contains the OQ Cl local copy (see 5.3.2.4); 

j) the OQ Cl Working Copy attribute, which contains the OQ Cl working copy (see 5.3.2.4); 

k) the OQ Minimum Coalescing Time attribute, which contains the minimum coalescing time (see 

5.2.5.12.8) ; 

l) the OQ Maximum Coalescing Time attribute, which contains the maximum coalescing time (see 

5.2.5.12.9) ; 

m) the OQ Coalescing Count attribute, which contains the coalescing count (see 5.2.5.12.10); 

n) the OQ Wait For Rearm attribute, which specifies whether the device shall wait for a rearm before 
generating another interrupt (see 5.2.5.12.11); 

o) the OQ Interrupt Message Number attribute, which contains the interrupt message number (see 
5.2.5.12.12); 

p) the OQ MSI-X Disable attribute, which specifies whether the corresponding MSI-X interrupt is disabled: 

q) the OQ Spanning Allowed attribute, which indicates whether spanning is allowed for this OQ (see 
5.2.5.12.14); and 

r) the OQ Operational Queue Protocol attribute, which contains the operational queue protocol (see 
10 . 2 . 6 ). 

5.2.2.8 PQI Host Operational IQ Information class 

The PQI host operational IQ information represents an instance of the PQI Host Operational IQ Information class 
(see figure 9). 

Each instance of the PQI Host Operational IQ Information class (see figure 9) contains the following attributes 
that describe an instance of the Operational IQ class (see 5.2.5.9 and figure 13): 

a) the IQ ID attribute, which contains the IQ ID (see 5.2.5.9.2); 

b) the IQ Element Array Address attribute, which contains the IQ element array address (see 5.2.5.9.3); 
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c) the IQ Number Of Elements attribute, which contains the number of elements in the IQ (see 5.2.5.9.5); 

d) the IQ Element Length attribute, which contains the length in bytes of the elements of the IQ (see 
5.2.5.9.4); 

e) the IQ Spanning Allowed attribute, which indicates whether spanning is allowed for this IQ (see 
5.2.5.9.8); 

f) the IQ PI Address attribute, which contains the IQ PI address (see 5.2.5.9.6); 

g) the IQ PI Local Copy attribute, which contains the IQ PI local copy (see 5.3.2.3); 

h) the IQ PI Working Copy attribute, which contains the IQ PI working copy (see 5.3.2.3); 

i) the IQ Cl Address attribute, which contains the IQ Cl address (see 5.2.5.9.7); 

j) the IQ Cl Local Copy attribute, if any, which contains the IQ Cl local copy (see 5.3.2.4); 

k) the IQ Cl Working Copy attribute, if any, which contains the IQ Cl working copy (see 5.3.2.4); and 

l) the IQ Operational Queue Protocol attribute, which contains the operational queue protocol (see 10.2.6)^ 
and 

m) the IQ Arbitration Priority attribute, which contains the IQ arbitration priority (see 5.3.5) . 


5.2.3 PQI device classes 


5.2.3.1 PQI device classes overview 

Figure 10 describes the PCI Express classes related to the PQI device. 



Figure 10 — PQI Device class and PCI Express classes 
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Figure 11 describes the classes related to the PQI device, showing the relationship between the following 


a) PQI Device (see 5.2.3.2); 

b) OQ (see 5.2.5.10); 

c) Cl (see 5.2.5.6); 

d) IQ (see 5.2 5.7); 

e) PI (see 5.2.5 5); 

f) PD State Machine (see 5.2.3.3); 

g) PQI Device Management Device Server (see 5.2.3.4); 

h) PQI Device Operational Device Server Interface (see 5.2.3.5); 

i) Administrator OQ Cl (see 5.2.3.6); 

j) Administrator IQ PI (see 5.2.3.7); 

k) Operational OQ Cl (see 5.2.3.8); 

l) Operational IQ PI (see 5.2.3.9); 

m) PQI Device Administrator OQ Information (see 5.2.3.10); 

n) PQI Device Operational OQ Information (see 5.2.3.11); 

o) PQI Device Administrator IQ Information (see 5.2.3.12); and 

p) PQI Device Operational IQ Information (see 5.2.3.13). 
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Figure 11 — PQI Device class model 
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5.2.3.2 PQI Device class 

The PQI Device class (see figure 11) contains the following classes: 

a) PD State Machine (see 5.2.3.3); 

b) PQI Device Management Device Server (see 5.2.3.4); 

c) PQI Device Operational Device Server Interface (see 5.2.3.5); 

d) Administrator OQ Cl (see 5.2.3.6); 

e) Administrator IQ PI (see 5.2.3.7); 

f) Operational OQ Cl (see 5.2.3.8); 

g) Operational IQ PI (see 5.2.3.9); 

h) PQI Device Administrator OQ Information (see 5.2.3.10); 

i) PQI Device Operational OQ Information (see 5.2.3.11); 

j) PQI Device Administrator IQ Information (see 5.2.3.12); and 

k) PQI Device Operational IQ Information (see 5.2.3.13). 

The PQI device represents an instance of the PQI Device class (see figure 11). 

5.2.3.3 PD State Machine class 

The PD state machine (see 5.5) represents an instance of the PD State Machine class (see figure 11). 

5.2.3.4 PQI Device Management Device Server class 

The PQI device management device server represents an instance of the PQI Device Management Device 
Server class (see figure 11). 

A PQI device management device server performs administrator functions requested by the PQI host 
management application client. 

5.2.3.5 PQI Device Operational Device Server Interface class 

The PQI device operational device server interface represents an instance of the PQI Device Operational Device 
Server class (see figure 11). 

A PQI device operational device server provides services to the device queuing layer interface defined in the III 
layer standard (e.g., SOP) that include: 

a) enqueuing of lUs compliant with clause 9 to operational OQs; 

b) dequeuing of lUs compliant with clause 9 from operational IQs; and 

c) generating notifications of lUs on OQs available to be dequeued. 

The PQI Device Operational Device Server Interface class processes Enqueue To OQ() requests (see 5.3.2.5.2) 
and Dequeue From IQ() (see 5.3.2.6.1) requests from the host queuing layer interface defined in the IU layer 
standard (e.g., SOP). 

The PQI Device Operational Device Server Interface class generates IU Available On IQ operations to the device 
queuing layer interface defined in the IU layer standard (e.g., SOP). 

5.2.3.6 Administrator OQ Cl class 

The Administrator OQ Cl class (see figure 11) is a kind of Cl class (see 5.2.5.6) and is part of the OQ class (see 
5.2.5.10). 

5.2.3.7 Administrator IQ PI class 

The IQ PI class (see figure 11) is a kind of PI class (see 5.2.5.5) and is part of the IQ class (see 5.2.5.7). 

5.2.3.8 Operational OQ Cl class 

The Operational OQ Cl class (see figure 11) is a kind of Cl class (see 5.2.5.6) and is part of the OQ class (see 
5.2.5.10). 
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5.2.3.9 Operational IQ PI class 

The Operational IQ PI class (see figure 11) is a kind of PI class (see 5.2.5.5) and is part of the IQ class (see 

5.2.5.7). 

5.2.3.10 PQI Device Administrator OQ Information class 

The PQI device administrator OQ information represents an instance of the PQI Device Administrator OQ 
Information class (see figure 11). 

Each instance of the PQI Device Administrator OQ Information class (see figure 11) contains the following 
attributes that describe an instance of the Administrator OQ class (see 5.2.5.11 and figure 13): 

a) the OQ Element Array Address attribute, which contains the OQ element array address (see 5.2.5.11.4); 

b) the OQ Element Length attribute, which contains the length in bytes of the elements of the OQ (see 

5.2.5.11.5) ; 

c) the OQ Number Of Elements attribute, which contains the number of elements in the OQ (see 

5.2.5.11.6) ; 

d) the OQ PI Address attribute, which contains the OQ PI address (see 5.2.5.11.7); 

e) the OQ PI Local Copy attribute, which contains the OQ PI local copy (see 5.3.2.3); 

f) the OQ PI Working Copy attribute, which contains the OQ PI working copy (see 5.3.2.3); 

g) the OQ Cl Address attribute which, contains the OQ Cl address in PQI device memory space (see 
5.2.5.11.8); 

h) the OQ Cl Local Copy attribute, if any, which contains the OQ Cl local copy (see 5.3.2.4); and 

i) the OQ Cl Working Copy attribute, if any, which contains the OQ Cl working copy (see 5.3.2.4). 

5.2.3.11 PQI Device Operational OQ Information class 

The PQI device operational OQ information represents an instance of the PQI Device Operational OQ 
Information class (see figure 11). 

Each instance of the PQI Device Operational OQ Information class (see figure 9) contains the following attributes 
that describe an instance of the Operational OQ class (see 5.2.5.12 and figure 13): 

a) the OQ ID attribute, which contains the OQ ID (see 5.2.5.12.2): 

b) the OQ Element Array Address attribute, which contains the OQ element array address (see 5.2.5.12.3); 

c) the OQ Element Length attribute which contains the length in bytes of the elements of the IQ (see 
5.2.5.12.4); 

d) the OQ Number Of Elements attribute, which contains the number of elements in the IQ (see 5.2.5.12.5); 

e) the OQ PI Address attribute, which contains the OQ PI address (see 5.2.5.12.6); 

f) the OQ PI Local Copy attribute, which contains the OQ PI local copy (see 5.3.2.3); 

g) the OQ PI Working Copy attribute, which contains the OQ PI working copy (see 5.3.2.3); 

h) the OQ Cl Address attribute, which contains the OQ Cl address in PQI device memory space (see 

5.2.5.12.7) ; 

i) the OQ Cl Local Copy attribute, if any, which contains the OQ Cl local copy (see 5.3.2.4); 

j) the OQ Cl Working Copy attribute, if any, which contains the OQ Cl working copy (see 5.3.2.4); 

k) th e OQ I D attr i but e , wh i ch contains th e OQ I D (s ee 5.2.5.12.2); 

l) the OQ Spanning Allowed attribute, which indicates whether spanning is allowed for this OQ and is equal 
to the value of the outbound spanning bit in the IU layer specific descriptor of the REPORT PQI 
DEVICE CAPABILITY parameter data (see 10.2.2.3); ae4 

m) the OQ Minimum Coalescing Time attribute, which contains the minimum coalescing time (see 

5.2.5.12.8) : 

n) the OQ Maximum Coalescing Time attribute, which contains the maximum coalescing time (see 

5.2.5.12.9) : 

o) the OQ Coalescing Count attribute, which contains the coalescing count (see 5.2.5.12.10): 

p) the OQ Wait For Rearm attribute, which specifies whether the device shall wait for a rearm before 

generating another interrupt (see 5.2.5.12.11): 

q) the OQ Interrupt Message Number attribute, which contains the interrupt message number (see 

5.2.5.12.12): 
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r) the OQ MSI-X Disable attribute, which specifies whether the corresponding MSI-X interrupt is disabled: 

and 

s) the OQ Queue Protocol attribute, which indicates the operational queue protocol (see table 83) that is 
supported by this operational OQ. 

5.2.3.12 PQI Device Administrator IQ Information class 

The PQI device administrator IQ information represents an instance of the PQI Device Administrator IQ 
Information class (see figure 11). 

Each instance of the PQI Device Administrator IQ Information class (see figure 11) contains the following 
attributes that describe an instance of the Administrator IQ class (see 5.2.5.8 and figure 13): 

a) the IQ Element Array Address attribute, which contains the IQ element array address (see 5.2.5.8.2); 

b) the IQ Element Length attribute, which contains the length in bytes of the IQ element (see 5.2.5.8.3); 

c) the IQ Number Of Elements attribute, which contains the number of elements in the IQ (see 5.2.5.8.4); 

d) the IQ PI Address attribute, which contains the IQ PI address in PQI device memory space (see 

5.2.5.8.5) ; 

e) the IQ PI Local Copy attribute, if any, which contains the IQ PI local copy (see 5.3.2.3); 

f) the IQ PI Working Copy attribute, if any, which contains the IQ PI working copy (see 5.3.2.3); 

g) the IQ Cl Address attribute, which contains the IQ Cl address in PQI device memory space (see 

5.2.5.8.6) ; 

h) the IQ Cl Local Copy attribute, which contains the IQ Cl local copy (see 5.3.2.4); and 

i) the IQ Cl Working Copy attribute, which contains the IQ Cl working copy (see 5.3.2.4). 

5.2.3.13 PQI Device Operational IQ Information class 

The PQI device operational IQ information represents an instance of the PQI Device Operational IQ Information 
class (see figure 11). 

Each instance of the PQI Device Operational IQ Information class (see figure 11) contains the following attributes 
that describe an instance of the Operational IQ class (see 5.2.5.9 and figure 13): 

a) the IQ Element Array Address attribute, which contains the IQ element array address (see 5.2.5.9.3); 

b) the IQ Element Length attribute, which contains the length in bytes of the elements of the IQ (see 
5.2.5.9.4); 

c) the IQ Number Of Elements attribute, which contains the number of elements in the IQ (see 5.2.5.9.5); 

d) the IQ PI Address attribute, which contains the IQ PI address in PQI device memory space (see 

5.2.5.9.6) ; 

e) the IQ PI Local Copy attribute, if any, which contains the IQ PI local copy (see 5.3.2.3); 

f) the IQ PI Working Copy attribute, if any, which contains the IQ PI working copy (see 5.3.2.3); 

g) the IQ Cl Address attribute, which contains the IQ Cl address (see 5.2.5.9.7); 

h) the IQ Cl Local Copy attribute, which contains the IQ Cl local copy (see 5.3.2.4); 

i) the IQ Cl Working Copy attribute, which contains the IQ Cl working copy (see 5.3.2.4); 

j) the IQ ID attribute, which contains the IQ ID (see 5.2.5.9.2); 

k) the IQ Spanning Allowed attribute, which indicates whether spanning is allowed for this IQ and is equal to 
the value of the inbound spanning bit in the IU layer specific descriptor of the REPORT PQI DEVICE 
CAPABILITY parameter data (see 10.2.2.3); and 

l) the IQ Queue Protocol attribute, which indicates the operational queue protocol (see table 83) that is 
supported by this operational IQ : and 

m) the IQ Arbitration Priority attribute, which contains the IQ arbitration priority (see 5.3.5) . 

5.2.4 PQI service delivery subsystem classes 

5.2.4.1 PQI service delivery subsystem classes overview 

Figure 12 describes the classes related to PQI service delivery subsystem, showing the relationship between the 
following classes: 

a) PQI Service Delivery Subsystem (see 5.2.4.2); 

b) PCI Express Fabric (see 5.2.4.3); and 
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c) PQI Queue Structure (see 5.2.4.4). 



Figure 12 — PQI Service Delivery Subsystem class diagram 

5.2.4.2 PQI Service Delivery Subsystem class 

Each instance of a PQI Service Delivery Subsystem class shall contain the following objects: 

a) one PCI Express fabric; and 

b) one or more PQI queue structures. 

5.2.4.3 PCI Express Fabric class 

The PCI Express Fabric class connects the PQI Host and the PQI device in the PQI domain, providing a 
mechanism through which application clients communicate with device servers and task managers. 

NOTE 4 - The PCI Express Fabric class includes backplane traces, cables, and PCIExpress switches (see 
PCIe). 

5.2.4.4 PQI Queue Structure class 

The PQI Queue Structure class (see figure 12) contains the following classes: 

a) Administrator IQ (see 5.2.5.8); 

b) Administrator OQ (see 5.2.5.11); 

c) Operational IQ (see 5.2.5.9); and 

d) Operational OQ (see 5.2.5.12). 

Each instance of a PQI Queue Structure class (see figure 12) shall contain the following objects: 

a) zero or one Administrator IQ; 

b) zero or one Administrator OQ; 

c) zero or more Operational IQs; and 

d) zero or more Operational OQs. 
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5.2.5 Circular queue classes 

5.2.5.1 Circular queue classes overview 

Figure 13 describes the classes related to the circular queue, showing the relationship between the following 
classes: 

a) Circular Queue (see 5.2.5.2); 

b) Element Array (see 5.2.5.3); 

c) Element (see 5.2.5.4); 

d) PI (see 5.2.5.5); 

e) Cl (see 5.2.5.6); 

f) IQ (see 5.2.5.7); 

g) Administrator IQ (see 5.2.5.8); 

h) Operational IQ (see 5.2.5.9); 

i) OQ (see 5.2.5.10); 

j) Administrator OQ (see 5.2.5.11); and 

k) Operational OQ (see 5.2.5.12). 



Figure 13 — Circular Queue classes 
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5.2.5.2 Circular Queue class 

5.2.5.2.1 Circular Queue class overview 

The Circular Queue class (see figure 13) contains the following classes: 

a) Element Array (see 5.2.5.3); 

b) PI (see 5.2.5.5); and 

c) Cl (see 5.2.5.6). 

The Circular Queue class (see figure 13) may be substituted with: 

a) the Operational IQ class (see 5.2.5.9); or 

b) the Administrator IQ class (see 5.2.5.8). 

For the Circular Queue class object rules see 5.2.5.4 and 5.3.2.1. 

5.2.5.2.2 Element Array Address attribute 

The Element Array Address attribute contains the memory space address of the first byte of the element array. 
For constraints on the Element Array Address attribute see: 

a) 5.2.5.8 for the Administrator IQ class constraints; 

b) 5.2.5.9 for the Operational IQ class constraints; 

c) 5.2.5.11 for the Administrator OQ class constraints; and 

d) 5.2.5.12 for the Operational OQ class constraints. 

5.2.5.2.3 PI Address attribute 

The PI Address attribute contains the memory space address of the PI. 

For constraints on the PI Address attribute see: 

a) 5.2.5.8 for the Administrator IQ class constraints; 

b) 5.2.5.9 for the Operational IQ class constraints; 

c) 5.2.5.11 for the Administrator OQ class constraints; and 

d) 5.2.5.12 for the Operational OQ class constraints. 

5.2.5.2.4 Cl Address attribute 

The Cl Address attribute contains the memory space address of the Cl. 

For constraints on the Cl Address attribute see: 

a) 5.2.5.8 for the Administrator IQ class constraints; 

b) 5.2.5.9 for the Operational IQ class constraints; 

c) 5.2.5.11 for the Administrator OQ class constraints; and 

d) 5.2.5.12 for the Operational OQ class constraints. 

5.2.5.3 Element Array class 

5.2.5.3.1 Element Array class overview 

The Element Array class contains the following class: 
a) Element (see 5.2.5.4). 

5.2.5.3.2 Number Of Elements attribute 

The Number Of Elements attribute contains the number of elements in the element array. 
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For constraints on the Number Of Elements attribute see: 

a) 5.2.5.8 for the Administrator IQ class constraints; 

b) 5.2.5.9 for the Operational IQ class constraints; 

c) 5.2.5.11 for the Administrator OQ class constraints; and 

d) 5.2.5.12 for the Operational OQ class constraints. 

5.2.5.3.3 Element Length attribute 

The Element Length attribute contains the length in bytes of an element in the element array (i.e., the element 
length). The element length shall be a multiple of 16 bytes. 

For constraints on the Element Length attribute see: 

a) 5.2.5.8 for the Administrator IQ class constraints; 

b) 5.2.5.9 for the Operational IQ class constraints; 

c) 5.2.5.11 for the Administrator OQ class constraints; and 

d) 5.2.5.12 for the Operational OQ class constraints. 

5.2.5.4 Element class 

The Element class is one element in an element array. 

Each instance of an Element class shall: 

a) contain from 16 to 1 048 560 bytes; and 

b) be an integer multiple of 16. 

5.2.5.5 PI class 

5.2.5.5.1 PI class overview 

The PI class is an index of a circular queue’s element array where the new entries are written by the producer 
(see 5.3.2.1). 

5.2.5.5.2 Index attribute 

The Index attribute specifies the contents of the PI. 

5.2.5.6 Cl class 

5.2.5.6.1 Cl class overview 

The Cl class is an index of a circular queue’s element array where the new entries are read by the consumer 
(see 5.3.2.1). 

5.2.5.6.2 Index attribute 

The Index attribute specifies the contents of the Cl. 

5.2.5.7 IQ class 

5.2.5.7.1 IQ functional overview 

An IQ is a circular queue used to transfer lUs from a PQI host to a PQI device. 

For an IQ: 

a) the IQ element array starts in memory space at the IQ element array address; 

b) the IQ Cl is contained in the IQ Cl dword (see 7.1.1) which is located at the IQ Cl address; and 

c) the IQ PI is contained in the IQ PI register (see 7.1.2) which is located at the IQ PI address and shall be 
in PQI device memory space. 

The PQI host maintains an IQ PI local copy. 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 


40 



| T10/BSR INCUS 507 Revision 01 


16 April 2015 


The PQI device maintains an IQ Cl local copy. 

As specified by PCIe, the PQI device does not use PCI memory transactions to access: 

a) the IQ PI; 

b) an IQ element array that is located in PQI device memory space; 

c) an IQ Cl that is located in PQI device memory space; and 

d) the PQI device memory space. 

A PQI host shall not use the Relaxed Ordering ordering type (see PCIe) in memory transactions accessing the IQ 
element array, IQ Cl, or IQ PI. 

A PQI device shall not use the Relaxed Ordering ordering type in memory transactions accessing the IQ element 
array or IQ Cl. 

A PQI device shall use the ID-Based Ordering ordering type (see PCIe) in memory transactions accessing the IQ 
element array and IQ Cl unless the IQ element array and IQ Cl are not both located in PQI host memory space. 
The mechanism for determining the location of the IQ element array and IQ Cl is outside the scope of this 
standard. 
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5.2.5.7.2 Example of IQ object locations that are not separated 

Figure 14 shows an IQ example where: 

a) the IQ element array is in the PQI host memory space; 

b) the IQ Cl is in the PQI host memory space; and 

c) the IQ PI is in the PQI device memory space. 



[^Label^l Object that is accessible over PCI Express 


Figure 14 — Example of IQ object locations that are not separated 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 


42 




































































| T10/BSR INCUS 507 Revision 01 


16 April 2015 


5.2.5.7.3 Example of IQ object locations that are separated 

Figure 15 shows an IQ example where: 

a) the IQ element array is in the memory space of one PCI function; 

b) the IQ Cl is in the memory space of another PCI function; 

c) the IQ PI is in the PQI device memory space; and 

d) the PQI host is separated from all of them. 



rwi 


Optional object that is not accessible over PCI Express 
Object that is accessible over PCI Express 


Figure 15 — Example where IQ object locations are separated 
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5.2.5.8 Administrator IQ class 

5.2.5.8.1 Administrator IQ class overview 

The Administrator IQ class is a kind of IQ class (see 5.2.5.7). 

5.2.5.8.2 Element Array Address attribute 

For an Administrator IQ class: 

a) the address alignment of the element array is 64 bytes; and 

b) the Element Array Address attribute is specified and indicated in the administrator iq element array 
address field in the Administrator IQ Element Array Address register (see 6.2.13). 

5.2.5.8.3 Element Length attribute 

For an Administrator IQ class, the Element Length attribute is indicated in the administrator iq element length 
field in the PQI Device Capability register (see 6.2.6). 

5.2.5.8.4 Number Of Elements attribute 

For an Administrator IQ class the Number Of Elements attribute: 

a) is indicated in the number of administrator iq elements field in the Administrator Queue Parameter 
register (see 6.2.17); 

b) minimum value is two and maximum value is indicated in the maximum administrator iq elements field 
in the PQI Device Capability register (see 6.2.6); and 

c) maximum value is less than or equal to 255. 

5.2.5.8.5 PI Address attribute 

For an Administrator IQ class, the PI Address attribute is specified and indicated in the administrator iq pi 
offset field in the Administrator IQ PI Offset register (see 6.2.11). 

5.2.5.8.6 Cl Address attribute 

For an Administrator IQ class: 

a) the address alignment of the IQ Cl is 64 bytes; and 

b) the Cl Address attribute is specified and indicated in the administfrator iq ci address field in the 
Administrator IQ Cl Address register (see 6.2.15). 

5.2.5.9 Operational IQ class 

5.2.5.9.1 Operational IQ class overview 

The Operational IQ class is a kind of IQ class (see 5.2.5.7). 

5.2.5.9.2 IQ ID attribute 

The IQ ID attribute contains the IQ ID (see 5.1). 

The IQ ID attribute is: 

a) specified in the iq id field in the CREATE OPERATIONAL IQ request (see 10.2.5.1); and 

b) indicated in the iq id field in the operational IQ property descriptor in the REPORT OPERATIONAL IQ 
LIST parameter data (see 10.2.11.3). 

The minimum value is one and the maximum value is 65 535. 
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5.2.5.9.3 Element Array Address attribute 

For an Operational IQ class: 

a) the minimum address alignment of the element array is 64 bytes; 

b) the Element Array Address attribute is specified in the iq element array address field in the CREATE 
OPERATIONAL IQ request (see 10.2.5.1); and 

c) the Element Array Address attribute is indicated in the iq element array address field in the operational 
IQ property descriptor in the REPORT OPERATIONAL IQ LIST parameter data (see 10.2.11.3). 

5.2.5.9.4 Element Length attribute 

For an Operational IQ class, the Element Length attribute: 

a) is specified in the element length field in the CREATE OPERATIONAL IQ request (see 10.2.5.1); 

b) is indicated in the element length field in the operational IQ property descriptor in the REPORT 
OPERATIONAL IQ LIST parameter data (see 10.2.11.3); and 

c) minimum value is 16 bytes and maximum value is 1 048 560 (i.e., 16 * 65 535) bytes. 

5.2.5.9.5 Number Of Elements attribute 

For an Operational IQ class, the Number Of Elements attribute: 

a) is specified in the number of elements field in the CREATE OPERATIONAL IQ request (see 10.2.5.1); 

b) is indicated in the number of elements field in the operational IQ property descriptor in the REPORT 
OPERATIONAL IQ LIST parameter data (see 10.2.11.3); 

c) minimum value is two and maximum value is indicated in the maximum operational iq elements field in 
the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3); and 

d) the maximum value is less than or equal to 65 535. 

5.2.5.9.6 PI Address attribute 

For an Operational IQ class, the PI Address attribute is: 

a) indicated by the PQI device; 

b) indicated in the iq pi offset field in the CREATE OPERATIONAL IQ response (see 10.2.5.2); and 

c) indicated in the iq pi offset field in the operational IQ property descriptor in the REPORT 
OPERATIONAL IQ LIST parameter data (see table 98). 

5.2.5.9.7 Cl Address attribute 

For an Operational IQ class: 

a) the minimum address alignment of the Cl is four bytes; 

b) the Cl Address attribute is specified in the iq ci address field in the CREATE OPERATIONAL IQ request 
(see 10.2.5.1); and 

c) the Cl Address attribute is indicated in the iq ci address field in the operational IQ property descriptor in 
the REPORT OPERATIONAL IQ LIST parameter data (see 10.2.11.3). 

5.2.5.9.8 Spanning Allowed attribute 

The Spanning Allowed attribute: 

a) indicates whether spanning is allowed for this operational IQ; and 

b) is reported in the inbound spanning bit in the IU layer specific descriptor of the REPORT PQI DEVICE 
CAPABILITY parameter data (see 10.2.2.3). 
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5.2.5.9.9 Queue Protocol attribute 

The Queue Protocol attribute: 

a) indicates the operational queue protocol (see table 83) that is supported by this operational IQ; and 

b) is specified in the operational queue protocol field in the CREATE OPERATIONAL IQ request (see 
10.2.5.1). 

5.2.5.9.10 Arbitration Priority attribute 

The Arbitration Priority attribute: 

a) is the arbitration priority selected for the operational IQ (see 5.3.5.3L 

b) is specified in the arbitration priority field in the CREATE OPERATIONAL IQ request (see 10.2.5.1): 

and 

c) is indicated in the arbitration priority field in the operational IQ property descriptor in the REPORT 

OPERATIONAL IQ LIST parameter data (see 10,2.11.31. 

5.2.5.10 OQ class 

5.2.5.10.1 OQ functional overview 

An OQ is a circular queue used to transfer lUs from a PQI device to a PQI host. 

For an OQ: 

a) the OQ element array starts in memory space at the OQ element array address; 

b) the OQ PI is contained in the OQ PI dword (see 7.1.4) which is located at the OQ PI address; and 

c) the OQ Cl is contained in the OQ Cl register (see 7.1.3) which is located at the OQ Cl address and is in 
PQI device memory space. 

The PQI host maintains an OQ Cl local copy. 

The PQI device maintains an OQ PI local copy. 

The PQI device: 

a) does not use memory transactions to access the OQ Cl; 

b) does not use memory transactions to access an OQ element array or an OQ PI that is located in PQI 
device memory space; and 

c) does not use memory transactions to access the PQI device memory space. 

A PQI host should not use the Relaxed Ordering ordering type (see PCIe) in memory transactions accessing the 
OQ element array, OQ Cl, or OQ PI. 

A PQI device shall not use the Relaxed Ordering ordering type in memory transactions accessing the OQ 
element array or OQ PI. 

A PQI device shall use the ID-Based Ordering ordering type (see PCIe) in memory transactions accessing the 
OQ element array and OQ PI unless the OQ element array and OQ PI are not both located in PQI host memory 
space. The mechanism for determining the location of the OQ element array and OQ PI is outside the scope of 
this standard. 
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5.2.5.10.2 Example of OQ object locations that are not separated 

Figure 16 shows an OQ example where: 

a) the OQ element array is in the PQI host memory space; 

b) the OQ PI is in the PQI host memory space; and 

c) the OQ Cl is in the PQI device memory space. 



^Label^ Object that is accessible over PCI Express 


Figure 16 — Example of OQ object locations that are not separated 
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5.2.5.10.3 Example of OQ object locations that are separated 

Figure 17 shows an OQ example where: 

a) the OQ element array is in the memory space of one PCI function; 

b) the OQ PI is in the memory space of another PCI function; 

c) the OQ Cl is in the PQI device memory space; and 

d) the PQI host is separated from all of them. 



Optional object that is not accessible over PCI Express 
Object that is accessible over PCI Express 


Figure 17 — Example of OQ object locations that are separated 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 


48 
































































































| T10/BSR INCUS 507 Revision 01 


16 April 2015 


5.2.5.10.4 Interrupt Message Number attribute 

The Interrupt Message Number attribute contains the interrupt message number (see PCIe). 

The minimum value is zero and the maximum value is 2 047. 

5.2.5.10.5 MSI-X Disable attribute 

The MSI-X Disable attribute specifies whether to disable PQI device sending the MSI-X interrupt to the PQI host. 

5.2.5.11 Administrator OQ class 

5.2.5.11.1 Administrator OQ class overview 

The Administrator OQ class is a kind of OQ class (see 5.2.5.10). 

5.2.5.11.2 Interrupt Message Number attribute 

The Interrupt Message Number attribute is inherited from the OQ class (see 5.2.5.10). 

The Interrupt Message Number attribute is: 

a) specified in the interrupt message number field in the Administrator Queue Parameter register (see 
6.2.17) when the administrator queue pair are created; and 

b) indicated in the interrupt message number field in the Administrator Queue Parameter register while 
the PQI device is in the PD3:Administrator_Queue_Pair_Ready state (see 5.5.5). 

5.2.5.11.3 MSI-X Disable attribute 

The MSI-X Disable attribute is inherited from the OQ class. 

The MSI-X Disable attribute is: 

a) specified in the msi-x disable bit in the Administrator Queue Parameter register (see 6.2.17) when the 

administrator queue pair are created: and 

b) indicated in the msi-x disable bit in the Administrator Queue Parameter register while the PQI device is 

in the PD3:Administrator Queue Pair Ready state (see 5.5.5). 

5.2.5.11.4 Element Array Address attribute 

For an administrator OQ: 

a) the address alignment of the element array is 64 bytes; and 

b) the Element Array Address attribute is specified and indicated in the administrator oq element array 
address field in the Administrator OQ Element Array Address register (see 6.2.14). 

5.2.5.11.5 Element Length attribute 

For an Administrator OQ class, the Element Length attribute is indicated in the administrator oq element 
length field in the PQI Device Capability register (see 6.2.6). 

5.2.5.11.6 Number Of Elements attribute 

For an Administrator OQ class, the Number Of Elements attribute: 

a) is indicated in the number of administrator oq elements field in the Administrator Queue Parameter 
register (see 6.2.17); 

b) minimum value is two and maximum value is indicated in the maximum administrator oq elements field 
in the PQI Device Capability register (see 6.2.6); and 

c) maximum value is less than or equal to 255. 
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5.2.5.11.7 PI Address attribute 

For an Administrator OQ class: 

a) the address alignment of the OQ PI is 64 bytes; and 

b) this attribute is specified and indicated in the administrator oq pi offset field in the Administrator OQ 
PI Address register (see 6.2.16). 

5.2.5.11.8 Cl Address attribute 

For an Administrator OQ class, the Cl Address attribute is indicated in the administrator oq ci address field in 
the Administrator OQ Cl Offset register (see 6.2.12). 

5.2.5.12 Operational OQ class 

5.2.5.12.1 Operational OQ class overview 

The Operational OQ class is a kind of OQ class (see 5.2.5.10). 

5.2.5.12.2 OQ ID attribute 

The OQ ID attribute contains the OQ ID (see 5.1). 

The OQ ID attribute is: 

a) specified in the oq id field in the CREATE OPERATIONAL OQ request (see 10.2.6.1); and 

b) indicated in the oq id field in the operational OQ property descriptor in the REPORT OPERATIONAL OQ 
LIST parameter data (see 10.2.12.3). 

The minimum value is one and the maximum value is 65 535. 

5.2.5.12.3 Element Array Address attribute 

For an Operational OQ class: 

a) the minimum address alignment of the element array is 64 bytes; 

b) the Element Array Address attribute is specified in the oq element array address field in the CREATE 
OPERATIONAL OQ request (see 10.2.6.1); and 

c) the Element Array Address attribute is indicated in the oq element array address field in the 
operational OQ property descriptor in the REPORT OPERATIONAL OQ LIST parameter data (see 
10.2.12.3). 

5.2.5.12.4 Element Length attribute 

For an Operational OQ class, the Element Length attribute is: 

a) specified in the element length field in the CREATE OPERATIONAL OQ request (see 10.2.6.1); 

b) indicated in the element length field in the operational OQ property descriptor in the REPORT 
OPERATIONAL OQ LIST parameter data (see 10.2.12.3); and 

c) minimum value is 16 bytes and maximum value is 1 048 560 (i.e., 16 * 65 535) bytes. 

5.2.5.12.5 Number Of Elements attribute 

For an Operational OQ class, the Number Of Elements attribute: 

a) is specified in the number of elements field in the CREATE OPERATIONAL OQ request (see 10.2.6.1); 

b) is indicated in the number of elements field in the operational OQ property descriptor in the REPORT 
OPERATIONAL OQ LIST parameter data (see 10.2.12.3); 

c) minimum value is two and maximum value is indicated in the maximum operational oq elements field in 
the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3); and 
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d) maximum value is less than or equal to 65 535. 

5.2.5.12.6 PI Address attribute 

For an Operational OQ class: 

a) the minimum address alignment of the PI is 4 bytes; 

b) this attribute is specified in the OQ pi address field in the CREATE OPERATIONAL OQ request (see 
10.2.6.1); and 

c) the PI Address attribute is indicated in the oq pi address field in the operational OQ property descriptor 
in the REPORT OPERATIONAL OQ LIST parameter data (see 10.2.12.3). 

5.2.5.12.7 Cl Address attribute 

For an Operational OQ class, the Cl Address attribute is: 

a) indicated by the PQI device; 

b) indicated in the oq ci offset field in the CREATE OPERATIONAL OQ response (see 10.2.6.2); and 

c) indicated in the oq ci offset field in the operational OQ property descriptor in the REPORT 
OPERATIONAL OQ LIST parameter data (see 10.2.12.3). 

5.2.5.12.8 Minimum Coalescing Time attribute 

The Minimum Coalescing Time attribute contains the minimum coalescing time in 100 ns intervals. 

The Minimum Coalescing Time attribute: 

a) is specified in the minimum coalescing time field in the CREATE OPERATIONAL OQ request (see 
10 . 2 . 6 . 1 ); 

b) is indicated in the minimum coalescing time field in the operational OQ property descriptor in the 
REPORT OPERATIONAL OQ LIST parameter data (see 10.2.12.3); and 

c) may be modified as specified in the minimum coalescing time field in the CHANGE OPERATIONAL OQ 
PROPERTIES request (see 10.2.10.1). 

The minimum value is zero and the maximum value is 4 294 967 295 (i.e., FFFF_FFFFh). 

5.2.5.12.9 Maximum Coalescing Time attribute 

The Maximum Coalescing Time attribute contains the maximum coalescing time in 100 ns intervals. 

The Maximum Coalescing Time attribute: 

a) is specified in the maximum coalescing time field in the CREATE OPERATIONAL OQ request (see 
10 . 2 . 6 . 1 ); 

b) is indicated in the maximum coalescing time field in the operational OQ property descriptor in the 
REPORT OPERATIONAL OQ LIST parameter data (see 10.2.12.3); and 

c) may be modified as specified in the maximum coalescing time field in the CHANGE OPERATIONAL OQ 
PROPERTIES request (see 10.2.10.1). 

The minimum value is zero and the maximum value is 4 294 967 295 (i.e., FFFF_FFFFh). 

5.2.5.12.10 Coalescing Count attribute 

The Coalescing Count attribute contains the coalescing count. 

The Coalescing Count attribute: 

a) is specified in the coalescing count field in the CREATE OPERATIONAL OQ request (see 10.2.6.1); 

b) is indicated in the coalescing count field in the operational OQ property descriptor in the REPORT 
OPERATIONAL OQ LIST parameter data (see 10.2.12.3); and 

c) may be modified as specified in the coalescing count field in the CHANGE OPERATIONAL OQ 
PROPERTIES request (see 10.2.10.1). 
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The minimum value is zero and the maximum value is 65 535. 

5.2.5.12.11 Wait For Rearm attribute 

The Wait for Rearm attribute specifies the wait for rearm setting (see 5.4.2.3). 

The Wait for Rearm attribute: 

a) is specified in the wait for rearm bit in the CREATE OPERATIONAL OQ request (see 10.2.6.1); 

b) is indicated in the wait for rearm bit in the operational OQ property descriptor in the REPORT 
OPERATIONAL OQ LIST parameter data (see 10.2.12.3); and 

c) may be modified as specified in the wait for rearm bit in the CHANGE OPERATIONAL OQ 
PROPERTIES request (see 10.2.10.1). 

The minimum value is zero and the maximum value is one. 

5.2.5.12.12 Interrupt Message Number attribute 

The Interrupt Message Number attribute is inherited from the OQ class. 

The Interrupt Message Number attribute is: 

a) specified in the interrupt message number field in the CREATE OPERATIONAL OQ request (see 

10.2.6.1) ; and 

b) indicated in the interrupt message number field in the operational OQ property descriptor in the 
REPORT OPERATIONAL OQ LIST parameter data (see 10.2.12.3). 

5.2.5.12.13 MSI-X Disable attribute 

The MSI-X Disable attribute is inherited from the OQ class. 

The MSI-X Disable attribute is: 

a) specified in the msi-x disable field in the CREATE OPERATIONAL OQ request (see 10.2.6.1): and 

b) indicated in the msi-x disable field in the operational OQ property descriptor in the REPORT 

OPERATIONAL OQ LIST parameter data (see 10.2.12.3). 

5.2.5.12.14 Spanning Allowed attribute 

The Spanning Allowed attribute indicates whether spanning is allowed for this operational OQ and is reported in 
the OUTBOUND SPANNING bit in the IU layer specific descriptor of the REPORT PQI DEVICE CAPABILITY 
parameter data (see 10.2.2.3). 

5.2.5.12.15 Queue Protocol attribute 

The Queue Protocol attribute: 

a) indicates the operational queue protocol (see table 83) that is supported by this operational OQ; and 

b) is specified in the opefrational queue protocol field in the CREATE OPERATIONAL OQ request (see 

10 . 2 . 6 . 1 ) . 
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5.3 Queuing model 

5.3.1 Queuing model overview 

The queuing model defines: 

a) circular queue configuration and operations (see 5.3.2.1); 

b) circular queue Pis (see 5.3.2.1); 

c) circular queue CIs (see 5.3.2.1); 

d) circular queue elements within an element array (see 5.3.2.1); and 

e) IQ priority (see 5.3.5). 

5.3.2 Circular queue model 

5.3.2.1 Circular queue functional overview 

Figure 18 shows the circular queue model. 


Linear representation: Element array 



Element: 


index of element 


occupied element (shaded) or 
vacant element (not shaded) 



Figure 18 — Circular queue 

A circular queue is created on request of a PQI host and the creation is completed on confirmation from the PQI 
device. 

The element array contains a number of contiguous elements of fixed size. All elements within an element array 
are of the same size. The size and the number of elements in an element array are configured when the circular 
queue is created. For an element array of size n, the elements are indexed from zero to (n-1). 

The element array address is the address of the start of the first element in the element array. The address of an 
element is determined by multiplying the index value of the element by the element length and adding that value 
to the element array address. 
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An element within a circular queue is an occupied element if: 

a) the Cl does not equal the PI; and 

b) the index of the element: 

A) is equal to the index contained in the Cl; 

B) is greater than the Cl and less than the PI and the Cl is less than the PI; 

C) is greater than the Cl and the Cl is greater than the PI; or 

D) is less than the PI and the Cl is greater than the PI. 

All other elements within the circular queue are vacant elements. 

A producer writes to vacant elements in an element array and a consumer reads from occupied elements in an 
element array. 

The PI contains the index of the next vacant element to be written by the producer. The initial value of the PI is 
zero. 

If the Cl does not equal the PI, then the Cl contains the index of the next occupied element to be read by the 
consumer. The initial value of the Cl is zero. 

The circular queue is empty while the Cl and PI are equal (i.e., all elements are vacant). 

The circular queue is full when the PI is one behind the Cl . There is always at least one vacant element in the 
element array. The maximum number of occupied elements in an element array of size n is n-1. 

Figure 19 shows an example of a full circular queue with Pl=4 and Cl=5, and an example of an empty circular 
queue with Pl=1 and Cl=1. 



Figure 19 — Example of a full circular queue and an empty circular queue 
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5.3.2.2 Relationship of IU to elements 

A circular queue contains a number of elements. 

A circular queue is used to transfer lUs. An IU may or may not fit within a single element of an element array. 

For operational queues, the PQI host and PQI device may provide the capability to span an IU across multiple 
elements to support the transfer of lUs that exceed the size of an element. This capability is called spanning. 

Spanning is not defined for administrator queues. 

The support of spanning for operational queues is reported in the IU layer specific descriptors in the REPORT 
PQI DEVICE CAPABILITY parameter data (see 10.2.2.3). 

The maximum inbound IU length and the maximum outbound IU length for operational queues is reported in the 
IU layer specific descriptors in the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3). 

If an IU to be produced exceeds the size of an element of the circular queue to which it is to be produced and the 
circular queue supports spanning, then the IU may be produced by dividing the IU into element sized pieces and 
placing these pieces into sequential elements of the queue. 

If an IU is spanned, then each portion except possibly the last portion of the spanned IU shall be equal to the size 
of an element of the circular queue to which the IU is to be produced. If an IU or the last portion of a spanned IU 
is smaller than the size of an element, then the IU content is placed into the element at the first byte of the 
element and continues contiguously until the end of the IU is reached. The content of any portion of an element 
that does not contain a portion of the content of an IU is undefined and shall be ignored by the consumer of the 
IU. 

If a consumer detects an IU whose length is greater than the specified maximum IU length, then the consumer 
shall: 

a) stop consuming from that operational queue; and 

b) if detected by the PQI device: 

1) set the op iq error bit to one in the PQI Device Status register (see 6.2.10); and 

2) set the iq error bit to one in the Operational IQ property descriptor (see 10.2.11.3). 

If the PQI device receives an administrator IU with the iu length field set to a value greater than the 
administrator OQ element length minus four, then: 

1) the PQI device shall set the error code to INVALID IU LENGTH IN ADMINISTRATOR REQUEST IU in 
the PQI Device Error register (see 6.2.18); and 

2) the PD state machine transitions as described in 5.5.5.5. 

This standard does not define specific reasons for a PQI device to stop producing to an OQ as a result of errors. 

A producer shall not request to produce an IU that is larger than the number of elements in the circular queue 
minus one, multiplied by the size of an element of the queue. The handling of this error condition is vendor 
specific. 

5.3.2.3 Queue producer 

The producer writes one or more lUs to vacant elements starting at the element indicated by the PI and 
continuing sequentially up to and including the element indicated by Cl minus two, wrapping at the end of the 
element array if necessary. After writing one or more lUs to the element array, the producer increments PI by the 
number of occupied elements produced, modulo the number of elements in the array. 

While writing to vacant elements in a circular queue, the producer maintains two copies of the PI: 

a) a PI local copy (i.e., a mirror of the value last written to the PI); and 

b) a PI working copy (i.e., a variable containing the index of the next vacant element in the element array). 

While writing one or more lUs to vacant elements in a circular queue, the producer compares the PI working copy 
to the Cl. The producer, after producing each IU: 

a) may update the PI and the PI local copy to the value of the PI working copy; and 
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b) should update the PI and the PI local copy to the value of the PI working copy if the Cl is approaching or 
equal to the PI local copy (i.e., the consumer considers the circular queue to be almost empty or empty). 

NOTE 5 - Since the consumer is consuming lUs from the circular queue at the same time as the producer is 
producing I Us to the circular queue, regular PI updates keep the consumer from detecting that the circular queue 
is empty and allow the consumer to continue consuming from the circular queue. The algorithm for determining 
the threshold is vendor specific. 

NOTE 6 - There is a benefit in reducing the number of memory write transactions used to update the PI by 
producing multiple lUs and updating the IQ PI with a single memory write transaction. 

A producer should use the same Traffic Class (see PCIe) for memory write transactions to the PI as it uses for 
memory write transactions to the element array. 

5.3.2.4 Queue consumer 

To read Ills, the consumer reads occupied elements starting from the element indicated by the Cl and continues 
sequentially wrapping at the end of the element array. After reading from one or more lUs, the consumer 
increments Cl by the number of occupied elements consumed, wrapping if the value equals the number of 
elements. 

While reading from elements in a circular queue, the consumer maintains two copies of the Cl: 

a) a Cl local copy (i.e., a mirror of the value last written to the Cl); and 

b) a Cl working copy (i.e., a variable containing the index of the next element in the element array to be 
read). 

While reading one or more lUs in the circular queue, the consumer compares the Cl working copy to the PI. The 
consumer, after consuming each III: 

a) may update the Cl and the Cl local copy to the value of the Cl working copy; 

b) should update Cl and the Cl local copy to the value of the Cl working copy if the PI is approaching the Cl 
local copy (i.e., the producer considers the circular queue to be almost full or to be full); and 

c) shall update Cl and the Cl local copy to the value of the Cl working copy if the Cl working copy is equal 
to the PI (i.e., the consumer considers the circular queue to be empty). 

To prevent deadlocks where the producer and consumer are both waiting on each other to update indexes, the 
consumer shall not refuse to update the Cl because the consumer is waiting for the producer to update the PI. 

NOTE 7 - Since the producer is producing lUs to the circular queue at the same time as the consumer is 
consuming lUs from the circular queue, regular Cl updates keep the producer from detecting that the circular 
queue is full and allows the producer to continue producing to the circular queue. The algorithm for determining 
the threshold is vendor specific. 

NOTE 8 - There is a benefit in reducing the number of memory write transactions by reading multiple lUs and 
updating the IQ Cl with a single memory write transaction. 

A consumer should use the same Traffic Class (see PCIe) for memory write transactions to the Cl as it uses for 
memory read transactions from the element array. 

The consumer should not perform memory read transactions of a vacant element. 

5.3.2.5 Enqueue operation 

5.3.2.5.1 Enqueue To IQ operation overview 

The Enqueue To IQ operation is modeled by the following procedure call: 

Enqueue To IQ (IN (IQ ID, Number of lUs, lUs)) 

The Enqueue To IQ operation is supported by the PQI operational application client Interface in the PQI host to 
enqueue Ills to the specified IQ. 
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Input arguments: 


IQ ID: The IQ to which the IU is to be produced. 

Number of lUs: The number of lUs to be produced. 

IUs: The lUs to be produced. 

The Enqueue To IQ operation produces one or more IUs to the element array of the IQ and increments the 
associated PI, wrapping at the end of the element array.The Enqueue To IQ operation may enqueue an III if 
there are sufficient vacant elements for that IU without requiring sufficient vacant elements for all IUs specified in 
the Enqueue To IQ request (see 5.3.2.5.3). 

5.3.2.5.2 Enqueue To OQ operation overview 

The Enqueue To OQ operation is modeled by the following procedure call: 

Enqueue To OQ (IN (OQ ID, Number of IUs, IUs)) 

The Enqueue To OQ operation is supported by the PQI device operational device server interface in the PQI 
device to enqueue IUs to the specified OQ. 

Input arguments: 


OQ ID: The OQ to which the IU is to be produced. 

Number of IUs: The number of IUs to be produced. 

IUs: The IUs to be produced. 

The Enqueue To OQ operation produces one or more IUs to the element array of the OQ and increments the 
associated PI, wrapping at the end of the element array.The Enqueue To OQ operation may enqueue an IU if 
there are sufficient vacant elements for that IU without requiring sufficient vacant elements for all IUs specified in 
the Enqueue To OQ request (see 5.3.2.5.4). 

5.3.2.5.3 PQI host enqueuing IUs to an IQ 

The PQI host determines the number of vacant IQ elements available to contain new IUs by comparing the IQ Cl 
and the IQ PI local copy. The number of elements available to contain new IUs is equal to the number of vacant 
elements in the IQ minus one. 
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Figure 20 shows an example location of the IQ Cl and the IQ PI local copy used by the PQI host to determine the 
number of vacant IQ elements. 



^Labei^ Object that is accessible over PCI Express 


Figure 20 — Example location of IQ Cl and PQI host IQ PI local copy 

The PQI host may produce one or more lUs to the IQ if the total number of elements required by the lUs to be 
produced is less than the number of vacant IQ elements. The PQI host should use the following steps to produce 
lUs to the IQ: 

1) for each IU to be produced: 

1) write the IU into the IQ element array beginning at the address indicated by the IQ PI working copy 
using wrapping as described in 5.3.2.1; and 

2) update the IQ PI working copy; 

2) update the IQ PI local copy with the IQ PI working copy; and 

3) update the IQ PI with the IQ PI working copy. 

5.3.2.5.4 PQI device enqueuing lUs to an OQ 

The PQI device determines the number of vacant OQ elements available to contain new lUs by comparing the 
OQ Cl and the OQ PI local copy. The number of elements available to contain new lUs is equal to the number of 
vacant elements in the IQ minus one. 
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Figure 21 shows an example location of the OQ Cl and the OQ PI local copy used by the PQI device to 
determine the number of vacant OQ elements. 



Key: 


I - Label ’ Object that is not accessible over PCI Express 
^Labei^ Object that is accessible over PCI Express 


Figure 21 — Example location of OQ Cl and PQI device OQ PI local copy 

The PQI device may produce one or more lUs to the OQ. If the total number of elements required by the lUs to 
be produced is less than or equal to the number of vacant OQ elements minus one, then the PQI device shall 
use the following steps to produce I Us to the OQ: 

1) for each IU to be produced: 

1) write the IU into the OQ element array beginning at the address indicated by the OQ PI working copy 
using wrapping as described in 5.3.2.1; and 

2) update the OQ PI working copy; 

2) update the OQ PI local copy with the OQ PI working copy; and 

3) update the OQ PI with the OQ PI working copy. 

If the IU layer requests that the PQI device send an administrator IU with the iu length field value larger than the 
administrator OQ element length, then: 

a) the PQI device shall set the error code to OQ SPANNING CONFLICT; and 

b) the PD state machine transitions as described in 5.5.5.5. 
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5.3.2.6 Dequeue operation 

5.3.2.6.1 Dequeue From IQ operation overview 

The Dequeue From IQ operation is modeled by the following procedure call: 

Dequeue From IQ (IN (IQ ID, Number of lUs), OUT (IUs)) 

Input arguments: 


IQ ID: The IQ from which the IU is to be consumed. 
Number of IUs: The number of IUs to be consumed. 

Output arguments: 


IUs: The IUs consumed. 

The Dequeue From IQ operation returns one or more IUs. The Dequeue From IQ operation waits for the circular 
queue to have the specified number of IUs to be consumed (see 5.3.2.6.4). 

5.3.2.6.2 Dequeue From OQ operation overview 

The Dequeue From OQ operation is modeled by the following procedure call: 

Dequeue From OQ (IN (OQ ID, Number of IUs), OUT (IUs)) 

Input arguments: 


OQ ID: The OQ from which the IU is to be consumed. 
Number of IUs: The number of IUs to be consumed. 

Output arguments: 


IUs: The IUs consumed. 

The Dequeue From OQ operation returns one or more IUs. The Dequeue From OQ operation waits for the 
circular queue to have the specified number of IUs to be consumed (see 5.3.2.6.3). 

5.3.2.6.3 PQI host dequeuing IUs from an OQ 

The PQI host determines the number of occupied OQ elements by comparing the OQ PI and the OQ Cl local 
copy. 
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Figure 22 shows an example location of the OQ PI and the OQ Cl local copy used by the PQI host to determine 
the number of occupied OQ elements. 



^Label^ Object that is accessible over PCI Express 


Figure 22 — Example location of OQ PI and PQI host OQ Cl local copy 

The PQI host may consume one or more lUs from the OQ using the following steps: 

1) for each IU to be consumed: 

1) read the IU from the OQ element array beginning at the address indicated by the OQ Cl working 
copy, using wrapping as described in 5.3.2.1; and 

2) update the OQ Cl working copy; 

2) update the OQ Cl local copy with the OQ Cl working copy; and 

3) update the OQ Cl with the OQ Cl working copy. 
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5.3.2.6.4 PQI device dequeuing lUs from an IQ 

The PQI device determines the number of occupied elements of an IQ by comparing the IQ PI and the IQ Cl local 
copy. 

Figure 23 shows an example location of the IQ PI and the PQI device IQ Cl local copy used by the PQI device to 
determine the number of available IQ elements. 





Object that is accessible over PCI Express 


Figure 23 — Example location of IQ PI and PQI device IQ Cl local copy 

The PQI device shall use the following steps to consume lUs from the IQ: 

1) for each IU to be consumed: 

1) read the IU from the IQ element array beginning at the address indicated by the IQ Cl working copy, 
using wrapping as described in 5.3.2.1; and 

2) update the IQ Cl working copy; 

2) update the IQ Cl local copy with the IQ Cl working copy; and 

3) update the IQ Cl with the IQ Cl working copy. 
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5.3.2.7 IU Available notification 

5.3.2.7.1 IU Available On IQ operation overview 

The IU Available On IQ operation is modeled by the following procedure call: 

IU Available On IQ (OUT (IQ ID)) 

The IU Available On IQ operation call is invoked by the PQI device operational device server interface in the PQI 
device. 

Output arguments: 


IQ ID: The operational IQ A which contains one or more lUs. 

Once an IU Available On IQ operation is invoked for an operational IQ, another IU Available On IQ operation 
should not be invoked until a Dequeue IU From IQ operation specifying that queue is invoked. 

5.3.2.7.2 IU Available On OQ operation overview 

The IU Available On OQ operation is modeled by the following procedure call: 

IU Available On OQ (OUT (OQ ID)) 

The IU Available On OQ operation call is invoked by the PQI host operational application client interface in the 
PQI host. 

Output arguments: 


OQ ID: The operational OQ,, which contains one or more lUs. 

Once an IU Available On OQ operation is invoked for an operational OQ, another IU Available On OQ operation 
should not be invoked until a Dequeue IU From OQ operation specifying that queue is invoked. 

5.3.2.7.3 IU Available On OQ notification 

After a PQI device produces an IU to an operational OQ, the PQI device sends an OQ service notification (see 
5.4). After a PQI host receives an OQ service notification, the PQI host should examine the PI and Cl of the 
operational OQ to determine if there are one or more occupied elements available in the operational OQ. 

After the PQI host operational application client interface completes the processing of a Dequeue From OQ 
request, the PQI host operational application client interface should examine the current values of the PI and Cl 
of the operational OQ to determine if the operational OQ contains any occupied elements. 

If an operational OQ contains occupied elements, then that operational OQ contains at least one IU. 

If an operational OQ contains occupied elements and an IU Available On OQ operation for which a 
corresponding Dequeue From OQ request has not been received is not pending, then an IU Available On OQ 
operation should be invoked. 

A PQI host operational application client interface may limit the number of parallel IU Available On OQ operations 
that are outstanding. 

A PQI host operational application client interface may assign vendor-specific priority levels to operational OQs 
and invoke IU Available On OQ operations based upon such priority levels. 

5.3.2.7.4 IU Available On IQ notification 

After a PQI host produces an IU to an operational IQ, the PQI host updates the PI for the operational IQ. The 
detection of an update to the PI of an operational IQ serves as notification to the PQI device that an IU may be 
available on the operational IQ. The PQI host should examine the PI and Cl of the associated operational IQ to 
determine if there are one or more occupied elements available in the operational IQ. 
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After the PQI operational device server completes the processing of a Dequeue From IQ request, the PQI device 
operational device server interface should examine the current values of the PI and Cl of the operational IQ to 
determine if the operational IQ contains any occupied elements. 

If a operational IQ contains occupied elements, then that operational IQ contains at least one IU. 

If an operational IQ contains occupied elements and an III Available On IQ operation for which a corresponding 
Dequeue From IQ request has not been received is not pending, then an IU Available On IQ operation should be 
invoked. 

A PQI device operational device server interface may limit the number of parallel IU Available On IQ operations 
that are outstanding. 

A PQI device operational device server interface may assign vendor-specific priority levels to IQs (see 5.3.5) and 
invoke IU Available On IQ operations based upon such priority levels. 

5.3.3 Creating circular queues 

5.3.3.1 Creating circular queues overview 

The PQI management application client initiates the creation of the administrator queue pair by writing to the 
Administrator Queue Configuration Function register (see 5.3.3.2). 

The PQI management application client initiates the creation of an operational IQ by: 

a) allocating resources for the element array to be used for the operational IQ; 

b) allocating resources for the IQ Cl; 

c) constructing a CREATE OPERATIONAL IQ request; and 

d) enqueuing the IU to the administrator IQ. 

The PQI management device server processes the CREATE OPERATIONAL IQ request by: 

a) allocating resources for the IQ PI; 

b) constructing a CREATE OPERATIONAL IQ response; and 

c) enqueuing the response to the administrator OQ. 

The PQI management application client initiates the creation of an operational OQ by: 

a) allocating resources for the element array to be used for the operational OQ; 

b) allocating resources for the OQ PI; 

c) constructing a CREATE OPERATIONAL OQ request; and 

d) enqueuing the IU to the administrator IQ. 

The PQI management device server processes the CREATE OPERATIONAL OQ request by: 

a) allocating resources for the OQ Cl; 

b) constructing a CREATE OPERATIONAL OQ response; and 

c) enqueuing the response to the administrator OQ. 

After the PQI management application client dequeues the CREATE OPERATIONAL IQ response or CREATE 
OPERATIONAL OQ response and the status field of the response is set to GOOD (see 10.1.5.1), then the 
queue has been successfully created. 

During the creation process, both the PQI management application client and the PQI management device 
server save attribute values needed for queue operation. 

See 5.3.3.3 for additional information on the creation of operation queues. 

5.3.3.2 Creating the administrator queue pair 

A PQI device shall support one administrator IQ and one administrator OQ (i.e., an administrator queue pair). 
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If the function and status code field is set to OOh (i.e., IDLE) in the Administrator Queue Configuration Function 
register (see 6.2.5) and the pqi device state field is set to 2h (i.e., PD2:AII_Registers_Ready) in the PQI Device 
Status register (see 6.2.10), then the PQI host may create an administrator queue pair using the following steps: 

1) read the PQI Device Capability register to determine the element length and the maximum number of 
elements in both the administrator IQ and administrator OQ; 

2) allocate the memory spaces using a mechanism outside the scope of this standard for the following: 

A) administrator IQ element array at an address with the required alignment (see 6.2.13); 

B) administrator OQ element array at an address with the required alignment (see 6.2.14); 

C) administrator IQ Cl at an address with the required alignment (see 6.2.15); and 

D) administrator OQ PI at an address with the required alignment (see 6.2.16); 

3) set: 

A) the administrator IQ Cl to zero; 

B) the administrator OQ PI to zero; 

C) the administrator IQ PI local copy to zero; and 

D) the administrator OQ Cl local copy to zero; 

4) set the PQI device registers as described in table 15; 

5) set the value of the function and status code field to Olh (i.e., CREATE ADMINISTRATOR QUEUE 
PAIR) in the Administrator Queue Configuration Function register; 

6) read the Administrator Queue Configuration Function register until: 

A) the function and status code field is set to OOh (i.e., IDLE); or 

B) 100 ms has elapsed after step 5); 

7) if the FUNCTION AND status code field is not set to OOh (i.e., IDLE) and 100 ms has elapsed, then read 
the Administrator Queue Configuration Function register; 

8) if the function AND status code field is set to OOh, then: 

A) read the administrator IQ PI offset from the Administrator IQ PI Offset register and save the value in 
PQI host local memory; and 

B) read the administrator OQ Cl offset from the Administrator OQ Cl Offset register and save the value 
in PQI host local memory; 

9) if the FUNCTION AND status code field is not set to OOh and PD state machine is in the PD4:Error state 
(see 5.5.6), then read the PQI Device Status register, the PQI Device Error register, and the PQI Device 
Error Details register, and report an error in a vendor specific manner; and 

10) if the FUNCTION AND status code field is not set to OOh and the PD state machine is not in the PD4:Error 
state, then report an error in a vendor specific manner. 
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Table 15 — PQI device registers to be written during administrator queue pair creation 


Register 

Field 

Value 

Administrator IQ Element Array 
Address (see 6.2.13) 

ADMINISTRATOR IQ ELEMENT 

ARRAY ADDRESS 

Administrator IQ element array 
address 

Administrator OQ Element Array 
Address (see 6.2.14) 

ADMINISTRATOR OQ ELEMENT 

ARRAY ADDRESS 

Administrator OQ element array 
address 

Administrator IQ Cl Address (see 
6.2.15) 

ADMINISTRATOR IQ Cl ADDRESS 

Administrator IQ Cl address 

Administrator OQ PI Address 
(see 6.2.16) 

ADMINISTRATOR OQ PI 

ADDRESS 

Administrator OQ PI address 

Administrator Queue Parameter 
(see 6.2.17) 

NUMBER OF ADMINISTRATOR IQ 

ELEMENTS 

Number of elements in the 
administrator IQ 

NUMBER OF ADMINISTRATOR OQ 

ELEMENTS 

Number of elements in the 
administrator OQ 

INTERRUPT MESSAGE NUMBER 

MSI-X Table entry used to generate 
the interrupt message for OQ PI 
updates to the administrator OQ in 
MSI-X mode. 


The PQI device reports an error for the CREATE ADMINISTRATOR QUEUE PAIR PD function if that PD function 
is invoked while: 

a) the function and status code field is not set to OOh (i.e., IDLE) in the Administrator Queue 
Configuration Function register (see 6.2.5); or 

b) the pqi device state field is set to 3h (i.e., PD2:AII_Registers_Ready) (see 5.5.5.4). 

If the PQI device is requested to create the administrator queue pair, the PQI device shall: 

1) allocate PQI device memory space for the administrator IQ PI; 

2) set the administrator iq pi offset field to the administrator IQ PI offset in the Administrator IQ PI Offset 
register (see 6.2.11); 

3) allocate PQI device memory space for the administrator OQ Cl; 

4) set the administrator oq ci offset field to the administrator OQ Cl offset in the Administrator OQ Cl 
Offset register (see 6.2.12); 

5) initialize: 

A) the administrator IQ PI to zero; 

B) the administrator OQ Cl to zero; 

C) the administrator IQ Cl local copy to zero; and 

D) the administrator OQ PI local copy to zero. 

and 

6) set the function and status code field to OOh (i.e., IDLE) in the Administrator Queue Configuration 
Function register (see 5.5.4.4). 
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If the PQI device fails to complete any of the steps to create the administrator queue pair, then the PQI device 
shall exit the sequence and: 

a) the PQI device shall not change the function and status code field from the current value of 01 h (i.e., 
CREATING ADMINISTRATOR QUEUE PAIR) in the Administrator Queue Configuration Function 
register; 

b) the PQI device shall set the error code to ERROR CREATING ADMINISTRATOR QUEUE PAIR in the 
PQI Device Error register (see 6.2.18 and 5.5.4.5); and 

c) the PD state machine transitions as described in 5.5.4.5. 

5.3.3.3 Creating operational queues 

Operational queues are created by the CREATE OPERATIONAL IQ function (see 10.2.5) and the CREATE 
OPERATIONAL OQ function (see 10.2.6) using the administrator queue pair. 

Prior to enqueuing a CREATE OPERATIONAL IQ request (see 10.2.5.1) to the administrator IQ, the PQI host 
should: 

1) use the REPORT PQI DEVICE CAPABILITY administrator function (see 10.2.2) to determine the 
supported element length and number of elements; 

2) allocate PCI memory spaces using a mechanism outside the scope of this standard for the following: 

A) the operational IQ element array, with a 64 byte address alignment; and 

B) the operational IQ Cl, with a 4 byte address alignment; 

and 

3) initialize the values in: 

A) the operational IQ Cl to zero; and 

B) the operational IQ PI local copy to zero. 

If the PQI device processes a CREATE OPERATIONAL IQ request, then the PQI device shall: 

1) allocate PQI device memory space for the administrator IQ PI; and 

2) initialize: 

A) the operational IQ PI to zero; and 

B) the operational IQ Cl local copy to zero. 

If the PQI device successfully completes creating the operational IQ, then the PQI device shall enqueue a 
CREATE OPERATIONAL IQ response (see 10.2.5.2) with the status field set to GOOD (see 10.1.5.1). 

If the PQI device fails to complete creating the operational IQ, then the PQI device shall enqueue a CREATE 
OPERATIONAL IQ response with the status field and the additional status descriptor set to a value that 
indicates the error (see 10.1.5.1). 

Prior to enqueuing a CREATE OPERATIONAL OQ request (see 10.2.6.1) to the administrator IQ, the PQI host 
should: 

1) use the REPORT PQI DEVICE CAPABILITY administrator function to determine the supported element 
length and number of elements; 

2) allocate PCI memory spaces using a mechanism outside the scope of this standard for the following: 

A) the operational OQ element array, with a 64 byte address alignment; and 

B) the operational OQ PI, with a 4 byte address alignment; 

and 

3) initialize the values in: 

A) the operational OQ PI to zero; and 

B) the operational OQ Cl local copy to zero. 

If the PQI device processes a CREATE OPERATIONAL OQ request, then the PQI device shall: 

1) allocate PQI device memory space for the administrator OQ Cl; and 

2) initialize: 

A) the operational OQ Cl to zero; and 

B) the operational OQ PI local copy to zero. 
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If the PQI device successfully completes creating the operational OQ, then the PQI device shall enqueue a 
CREATE OPERATIONAL OQ response (see 10.2.6.2) with the status field set to GOOD (see 10.1.5.1). 

If the PQI device fails to complete creating the operational OQ, then the PQI device shall enqueue a CREATE 
OPERATIONAL OQ response with the status field and the additional status descriptor set to a value that 
indicates the error (see 10.1.5.1). 

5.3.4 Deleting circular queues 

5.3.4.1 Deleting circular queues overview 

The management application client requests that the administrator queue pair and the operational queues be 
deleted in the following order: 

1) delete all of the operational IQs and operational OQs using administrator functions (see 10.2); and 

2) delete the administrator queue pair using the DELETE ADMINISTRATOR QUEUE PAIR PD function 
(see 6.2.5). 

5.3.4.2 Deleting the administrator queue pair 

If the function and status code field is set to OOh (i.e., IDLE) in the Administrator Queue Configuration Function 
register (see 6.2.5) and the pqi device state field is set to 3h (i.e., PD3:Administrator_Queue_Pair_Ready) in 
the PQI Device Status register (see 6.2.10), then the PQI host may delete the administrator queue pair using the 
following steps: 

1) set the value of the function and status code field to 02h (i.e., DELETE ADMINISTRATOR QUEUE 
PAIR) in the Administrator Queue Configuration Function register; 

2) read the Administrator Queue Configuration Function register until: 

A) the function and status code field is set to OOh (i.e., IDLE); or 

B) 100 ms has elapsed; 

3) if the FUNCTION AND status code field is not set to OOh (i.e., IDLE), then read the Administrator Queue 
Configuration Function register; 

4) if the FUNCTION AND status code field is not set to OOh (i.e., IDLE), then: 

A) read the PQI Device Status register; 

B) read the PQI Device Error register (see 6.2.18); and 

C) report an error in a vendor specific manner; 

and 

5) deallocate the PCI memory spaces using a mechanism outside the scope of this standard for the 
following: 

A) administrator IQ element array; 

B) administrator OQ element array; 

C) administrator IQ Cl; and 

D) administrator OQ PI. 

If the PQI device is requested to delete the administrator queue pair, then the PQI device shall: 

1) deallocate PQI device memory space for the administrator IQ PI; 

2) set the administrator iq pi offset field to zero in the Administrator IQ PI Offset register (see 6.2.11); 

3) deallocate PQI device memory space for the administrator OQ Cl; and 

4) set the administrator oq ci offset field to zero in the Administrator OQ Cl Offset register (see 6.2.12). 
If the PQI device successfully completes deleting the administrator queue pair, then: 

1) the PQI device shall set the function and status code field to OOh (i.e., IDLE) in the Administrator 
Queue Configuration Function register; and 

2) the PD state machine transitions as described in 5.5.5.4. 
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If the PQI device fails to complete the deletion of the administrator queue pair, then: 

a) the PQI device shall not change the function and status code field from the current value of 02h (i.e., 
DELETING ADMINISTRATOR QUEUE PAIR) in the Administrator Queue Configuration Function 
register; 

b) the PQI device shall set the error code to ERROR DELETING ADMINISTRATOR QUEUE PAIR in the 
PQI Device Error register (see 6.2.18); and 

c) the PD state machine transitions as described in 5.5.5.5. 

A PQI device shall delete the administrator queue pair during a PQI reset or a PCI Express reset. 

After a PQI reset or a PCI Express reset, the PQI host may deallocate the PCI memory spaces using a 
mechanism outside the scope of this standard for the following: 

a) administrator IQ element array; 

b) administrator OQ element array; 

c) administrator IQ Cl; and 

d) administrator OQ PI. 

5.3.4.3 Deleting operational queues 

Operational queues are deleted by the DELETE OPERATIONAL IQ function (see 10.2.7) and the DELETE 
OPERATIONAL OQ function (see 10.2.8) using the administrator queue pair. 

The PQI host should wait until the IQ is empty before issuing the DELETE OPERATIONAL IQ function. The 
result of deleting an operational IQ if it is not empty is not defined by this standard. 

The PQI host management application client should make sure that the corresponding operational OQ is not 
required for any pending operation before issuing the DELETE OPERATIONAL OQ function. The result of 
deleting an operational OQ if the operational OQ is still being used is not defined by this standard. 

If the PQI device is requested to delete an operational IQ, then the PQI device shall deallocate PQI device 
memory space for the operational IQ PI. 

If the PQI device successfully completes deleting the operational IQ, then the PQI device shall enqueue a 
DELETE OPERATIONAL IQ response (see 10.2.7.2) with the status field set to GOOD (see 10.1.5.1). 

If the PQI device fails to complete deleting the operational IQ, then the PQI device shall enqueue a DELETE 
OPERATIONAL IQ response with the status field and the additional status descriptor set to a value that 
indicates the error (see 10.1.5.1). 

After dequeuing a DELETE OPERATIONAL IQ response from the administrator OQ, the PQI host should 
deallocate the PCI memory spaces using a mechanism outside the scope of this standard for the following: 

a) operational IQ element array; and 

b) operational IQ Cl. 

If the PQI device is requested to delete an operational OQ, then the PQI device shall deallocate PQI device 
memory space for the operational OQ Cl. 

If the PQI device successfully completes deleting the operational OQ, then the PQI device shall enqueue a 
DELETE OPERATIONAL OQ response (see 10.2.8.2) with the status field set to GOOD (see 10.1.5.1). 

If the PQI device fails to complete deleting the operational OQ, then the PQI device shall enqueue a DELETE 
OPERATIONAL OQ response with the status field and the additional status descriptor set to a value that 
indicates the error (see 10.1.5.1). 

After dequeuing a DELETE OPERATIONAL OQ response from the administrator OQ, the PQI host should 
deallocate the PCI memory spaces using a mechanism outside the scope of this standard for the following: 

a) operational OQ element array; and 

b) operational OQ PI. 

A PQI device shall delete all operational IQs and all operational OQs during a PQI reset or a PCI Express reset. 
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After a PQI reset or a PCI Express reset, the PQI host may deallocate the PCI memory spaces using a 
mechanism outside the scope of this standard for the following: 

a) operational IQ element arrays; 

b) operational OQ element arrays; 

c) operational IQ CIs; and 

d) operational OQ Pis. 

| 5.3.5 IQ priority and IQ arbitration 

Th e PQ I d e v i c e shou l d consum e a ll I lls from th e adm i n i strator I Q ( i . e ., th e adm i n i strator I Q i s e mpty) b e for e 

consum i ng l Us from any op e rat i ona l I Q. 

5.3.5.1 IQ priority and IQ arbitration overview 

Each IQ is associated with an arbitration set that is used by the PQI device to determine from which IQ the next 

element is consumed. Only non-empty IQs participate in and affect IQ arbitration. 

The functional behavior of IQ arbitration consists of one or more of the following methods: 

a) round robin arbitration: 

b) weighted round robin arbitration: and 

c) priority arbitration. 

The input to the arbitration hierarchy is the set of non-empty IQs. The output of the arbitration hierarchy is the 

non-empty IQ from which the PQI device shall process the next element. 

In a round robin arbitration, all IQs in an arbitration set are treated with equal priority and equal weight. Figure 24 

shows an example of a round robin arbitration. 



Figure 24 — Example of a round robin arbitration 

A weighted round robin arbitration is similar to a round robin arbitration but with a different weight on each IQ. 

The weight in a weighted round robin arbitration is described as the number of arbitration bursts (see 5.3.5.2) to 

be consumed from the associated IQ during one round of weighted round robin arbitration. 

A PQI device may support up to three weighted round robin: 

a) AW A: 

b) AW B: and 

c) AW C. 

The AW A, AW B and AW C have the same priority. 
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The maximum weighted round robin weights supported by the PQI device are indicated by the maximum aw a 

field, maximum aw B field , and the maximum aw c field in the REPORT PQI DEVICE CAPABILITY function (see 

10.2.2V 

The PQI host specifies the weighted round robin weights using the aw a field, the aw b field and the aw c field in 

the CONFIGURE IQ ARBITRATION function (see 10.2.15V 

Figure 25 shows an example of a weighted round robin arbitration. 



One round 
of weighted 
round robin 
arbitration 



Key: ODD 



Elements 

Weighted round 
robin arbiter 


Figure 25 — Example of a weighted round robin arbitration 

In a priority arbitration, all elements from higher priority IQs are consumed before elements are consumed from 

lower priority IQs. Figure 26 shows an example of a priority arbitration. 



5.3.5.2 Arbitration burst 

The arbitration burst is applicable only to the round robin arbitration and weighted round robin arbitration, and is 

not applicable to the priority arbitration. 

The maximum size of an arbitration burst supported by a PQI device is reported in the maximum arbitration 

burst field in the REPORT PQI DEVICE CAPABILITY function (see 10.2.2). The PQI host specifies the 

maximum arbitration burst using the CONFIGURE IQ ARBITRATION function (see 10.2.15). The maximum 

arbitration burst setting is applicable to all IQs for a PQI device. 

The number of elements that may be consumed from each IQ per arbitration round is either the arbitration burst 

setting or the remaining occupied elements in the IQ, whichever is smaller. 
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Figure 27 shows an example of a round robin arbitration with the arbitration burst setting set to 2. 



Figure 27 — Example of a round robin arbitration with arbitration burst set to two 


Figure 28 shows an example of a weighted round robin arbitration with the arbitration burst setting set to 2. 



Figure 28 — Example of a weighted round robin arbitration with arbitration burst set to two 


5.3.5.3 Arbitration priorities 

The administrator IQ shall use high priority arbitration. The operational IQ shall use one of the following 

arbitration priorities: 


a) medium priority: 

b) low priority with weighted round robin A: 

c) low priority with weighted round robin B: and 

d) low priority with weighted round robin C. 


A PQI device shall support high priority arbitration priority and shall support at least one additional arbitration 

priority. 

The administrator IQ shall use high priority arbitration priority and an operational IQ shall use at least one of the 

lower priority abitration types (i.e., medium priority, low priority with weighted round robin A, low priority with 

weighted round robin B, or low priority with weighted round robin C ). 


The arbitration priorities supported bv a PQI device are reported bv the iq arbitration priority support 

bitmask field in the REPORT PQI DEVICE CAPABILITY function (see 10.2.21 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 


72 













































| T10/BSR INCUS 507 Revision 01 


16 April 2015 


The arbitration priority of an operational IQ is specified in the arbitration priority field when the operation IQ is 

created using CREATE OPERATIONAL IQ function (see 10.2.4). 

When more than one operational IQ is created with the same arbitration priority, an arbitration set is formed. The 

operational IQs within an arbitration set are consumed using round robin arbitration. 

Figure 29 shows an example of IQ arbitration using multiple arbitration priorities. 


High 

Priority 


Medium 

Priority 


Low priority - 
weighted 
round robin A 
AW A =3 


Low priority - 
weighted 
round robin B 
AW B =2 


Low priority - 
weighted 
round robin C 
AW C =1 



Figure 29 — Example of a IQ arbitration using multiple arbitration priorities 


The administrator IQ has the highest priority and elements are consumed when the administrator IQ is not empty. 

All elements in the operational IQs of the medium arbitration priority level are consumed before elements in the 

operational IQs of the low priority weighted round robin arbitration levels are consumed. 

All elements in the operational IQs are consumed in order based on arbitration priority: 

1) medium priority: 

2) low priority weighted round robin A: 

3) low priority weighted round robin B; and 

4) low priority weighted round robin C. 

When multiple IQs use the same medium priority arbitration priority, a round robin arbitration is used (e.g., in 

figure 6 a round robin arbitration is used for IQ-1, IQ-2 and IQ-3). 
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The next lower priority arbitration after the medium arbitration priority level are the low arbitration priority levels 

associated with weighted round robin A, weighted round robin B and weighted round robin C. 

In this example, the PQI host specifies a weight of 3 for AW A, a weight of 2 for AW B, and a weight of 1 for AW 

a 

The winning weighted round robin level consumes elements until empty or until arbitration burst is reached. 

The process continues with the next arbitration level. 

5.4 OQ service notification methods 

5.4.1 OQ service notification methods overview 

Table 16 lists the OQ service notification methods that are used by the PQI host to determine when an entry is 
available in an OQ. 

If MSI-X (see PCI) is enabled, then MSI-X mode is used. If MSI-X is not enabled then legacy INTx (see PCI) may 
be used. If the PQI host masks off the generation of MSI-X interrupts or legacy INTx interrupts by the PQI device 
and uses other methods (e.g., reading OQ PI) to determine when an event has occurred, then polled mode is 
being used. 


Table 16 — OQ service notification methods 


Mode 

PQI device 

PQI host 

MSI-X 

5.4.2 

5.4.5 

Legacy INTx 

5.4.3 

5.4.6 

Polled 

5.4.4 

5.4.7 


5.4.2 Sending OQ service notifications in MSI-X mode 

5.4.2.1 Sending OQ service notifications in MSI-X mode overview 

A memory write transaction used to send an MSI-X interrupt should use the same Traffic Class (see PCIe) that is 
used to write the IU to the OQ and to update the OQ PI for that OQ and shall not be sent until any update to the 
OQ PI that caused the generation of the MSI-X interrupt has been sent. 

5.4.2.2 Sending OQ service notifications for an administrator OQ 

In MSI-X mode, the PQI device shall send the PQI device interrupt each time after the administrator OQ PI is 
written with a new value. If the administrator OQ is mapped to the same MSI-X interrupt vector (see PCI) as one 
or more operational OQs in a PQI device, then interrupt coalescing for the MSI-X interrupt associated with that 
MSI-X interrupt vector is vendor specific. 

5.4.2.3 Sending OQ service notifications for an operational OQ 

If only one operational OQ is mapped to a MSI-X interrupt vector in a PQI device, then the PQI device sends an 
MSI-X interrupt (see PCI and PCIe) every time an interrupt event (see table 17) occurs. If more than one 
operational OQ is mapped to a MSI-X interrupt vector in a PQI device, then interrupt coalescing for the MSI-X 
interrupt associated with that MSI-X interrupt vector is vendor specific. 

In MSI-X mode, a PQI device interrupt event may occur when an operational OQ contains one or more occupied 
elements. 

A PQI device implements a coalescing timer for each operational OQ. If the coalescing timer is reset, then a 
coalescing timer is set to a value of zero. If the coalescing timer is started, then the coalescing timer increases as 
time elapses. If the coalescing timer is stopped, then the coalescing timer retains its current value. 
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For each operational OQ, a PQI device maintains the following attributes related to the generation of MSI-X 
interrupts: 

a) Minimum Coalescing Time attribute (see 5.2.5.12.8); 

b) Maximum Coalescing Time attribute (see 5.2.5.12.9); 

c) Coalescing Count attribute (see 5.2.5.12.10); 

d) Wait For Rearm attribute (see 5.2.5.12.11); ae4 

I e) Interrupt Message Number attribute (see 5.2.5.12.12) ; and 
f) MSI-X Disable attribute (see 5.2.5.12.13) . 

The Minimum Coalescing Time attribute, Maximum Coalescing Time attribute, Coalescing Count attribute, Wait 
J For Rearm attribute, and Interrupt Message Number attribute , and MSI-X Disable attribute are specified by the 
CREATE OPERATIONAL OQ function. 

The Minimum Coalescing Time attribute, Maximum Coalescing Time attribute, Coalescing Count attribute, and 
Wait For Rearm attribute may be modified by the CHANGE OPERATIONAL OQ PROPERTIES function. 

For an operational OQ: 

occupied element count = (n + OQ PI - OQ Cl) mod n 

where: 

occupied element count the number of occupied elements in the OQ; 

n is the number of elements in the OQ; 

OQ PI is the index of the OQ element where the producer writes next; and 

OQ Cl is the index of the OQ element where the consumer reads next. 


For an operational OQ an interrupt event occurs if: 

a) the condition described in table 17 is true; and 

b) the associated event described in table 17 occurs. 

If an interrupt event occurs, then the PQI device should send the MSI-X interrupt designated for that operational 
OQ. If more than one event in table 17 occurs at the same time for an operational OQ, then the PQI device shall 
only generate one MSI-X interrupt. 


Table 17 — Interrupt generation conditions and events 


Condition 

Event 

The occupied element count is greater than or equal to 
the Coalescing Count attribute and the Minimum 
Coalescing Time attribute is set to non-zero. 

The coalescing timer equals the Minimum 

Coalescing Time attribute. 

The occupied element count is greater than or equal to 
one and the Maximum Coalescing Time attribute is set 
to non-zero. 

The coalescing timer equals the Maximum 
Coalescing Time attribute. 

The coalescing timer is greater than or equal to the 
Minimum Coalescing Time attribute. 

PQI device writes to the operational OQ PI causing 
the occupied element count to be greater than or 
equal to the Coalescing Count attribute. 

The coalescing timer is greater than or equal to the 
Maximum Coalescing Time attribute. 

PQI device writes to the operational OQ PI causing 
the occupied element count to be non-zero. 


The delay between an event from table 17 and the MSI-X memory write transaction on the PCI Express interface 
is vendor specific. 
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After sending an interrupt for an operational OQ: 

a) if the Wait For Rearm attribute is set to zero, then the PQI device shall reset and start the coalescing 
timer; and 

b) if the Wait For Rearm attribute is set to one, then the PQI device shall reset and stop the coalescing 
timer. 


If: 


a) a memory write transaction to the operational OQ Cl dword is received with the rearm interrupt bit set 
to one (see 7.1.3); and 

b) the Wait For Rearm attribute is set to one, 

then the PQI device shall reset and start the coalescing timer. 


Figure 30 shows an example of interrupt coalescing with the wait for rearm bit set to zero. 


OQ Cl written; 
occupied element 
count may or 
may not = 0 



Send interrupt if 
occupied element >K 

count > 0 Send interrupt if 


Interrupt 

sent 


occupied element 
count > 

Coalescing Count 
attribute 


Send interrupt if 
occupied element 
count > Coalescing 
Count attribute 


y 


occupied element 
count > 0 after 
coalescing timer 
exceeds Maximum 
Coalescing Time 
attribute 


y 


Coalescing 
timer starts 


Coalescing 
timer equals 
Minimum Coalescing 
Time attribute 


Maximum Coalescing 
Time attribute 


Coalescing 
timer equals 


Figure 30 — Interrupt coalescing example with the wait for rearm bit set to zero 
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Figure 31 shows an example of interrupt coalescing with the wait for rearm bit set to one. 


OQ Cl written with 
REARM INTERRUPT 
bit set to one; 
occupied element 
count may or 
may not = 0 


Interrupt 

sent 


Coalescing 
timer starts 


Send interrupt if 
occupied element 
count > 

Coalescing Count 
attribute 


Send interrupt if 
occupied element 


Send interrupt if 
occupied element 
count > Coalescing 
Count attribute 


Send interrupt if 
occupied element 
count > 0 after 
coalescing timer 
exceeds Maximum 
Coalescing Time 
attribute 


Coalescing 
timer equals 
Minimum Coalescing 
Time attribute 


Coalescing 
timer equals 
Maximum Coalescing 
Time attribute 


Figure 31 — Interrupt coalescing example with the wait for rearm bit set to one 
5.4.3 Sending OQ service notifications in legacy INTx mode 

In legacy INTx mode, the PQI device sends Assert lNTx and Deassert lNTx Messages (see PCIe) to maintain a 
virtual wire that reflects whether interrupt sources are asserted or deasserted (i.e., level triggered). 

In legacy INTx mode, any OQ containing one or more occupied elements is an interrupt source. 

Figure 32 shows the legacy INTx interrupt sources and masks. 



Figure 32 — Legacy INTx sources and masks 
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The PQI device shall assert the virtual INTx wire while: 

a) any of its interrupt sources are asserted; and 

b) the Legacy INTx Interrupt Mask register interrupt mask bit is set to zero. 

The PQI device shall deassert the virtual INTx wire while: 

a) all of its interrupt sources are not asserted; or 

b) the Legacy INTx Interrupt Mask register interrupt mask bit is set to one. 

An OQ interrupt source is cleared when the OQ Cl equals the OQ PI (i.e., OQ is empty). 

5.4.4 Sending OQ service notifications in polled mode 

In polled mode, the PQI device shall not send interrupts. 

5.4.5 Servicing OQ service notifications in MSI-X mode 

In MSI-X mode, if the wait for rearm bit (see 5.4.2 and 10.2.6.1) is set to one, then after reading one or more 
elements from the OQ, the PQI host should set the rearm interrupt bit (see 7.1.3 and 10.2.6.1) to one before 
exiting the interrupt service routine (e.g., after consuming all occupied elements in the OQ). 

If the PQI host receives an interrupt assigned to more than one OQ, then the PQI host should consume all lUs 
from each OQ assigned to that interrupt. 

5.4.6 Servicing OQ service notifications in legacy INTx mode 

In legacy INTx mode, if the PQI host receives an interrupt, then the PQI host should: 

1) if the legacy INTx interrupt is shared with other PCI functions (see PCI), then read the Legacy INTx 
Interrupt Status register (see 6.2.7); and 

NOTE 9 - As specified by PCIe, the read from the Legacy INTx Status register ensures that all memory writes 
from the PQI device have completed. 

2) if the Legacy INTx Interrupt Status register interrupt pending bit is set to one (i.e., the PQI device is a 
source of the interrupt), then determine the PQI device’s interrupt source(s) by checking the OQ PI of 
each OQ to determine if the OQ is not empty. 

5.4.7 Servicing OQ service notifications in polled mode 

In polled mode, the PQI host should poll the OQ PI of each OQ to determine if the OQ is not empty. 
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5.5 PD (PQI device) state machine 

5.5.1 PD (PQI device) state machine overview 

The PD state machine describes the PQI device states and transitions for PCI configuration and device 
operation. 

This state machine consists of the following states: 

a) PDO:Power_On_And_Reset (see 5.5.2) (initial state); 

b) PD1 :PQI_Status_Available (see 5.5.3); 

c) PD2:AII_Registers_Ready (see 5.5.4); 

d) PD3:Administrator_Queue_Pair_Ready (see 5.5.5); and 

e) PD4:Error (see 5.5.6). 

The PD state machine shall start in the PDO:Power_On_And_Reset state when the PCI Function enters the DO 
uninitialized state (see PCI-PM), (e.g., upon power on or following a PCI Express reset (see PCIe)). 

The PQI device state is indicated by the pqi device state field in the PQI Device Status register (see 6.2.10). 
The PQI device shall set the pqi device state field (see table 29) to the appropriate value upon entry into each 
state. Unless otherwise specified, PCI-PM state transitions (see PCI-PM) do not cause PD state transitions. 

Figure 33 describes the PD state machine. 


PD (PQI device) state machine 


PD1: 

PQI_Status_Available 


PD2: 

AII_Registers_Ready 


PD3: 

Administrator. 

Queue_Pair_Ready 


PDO: 

Power_On_ 

And_Reset 


PD4: 

Error 


Figure 33 — PD (PQI device) state machine 
5.5.2 PDO:Power_On_And_Reset state 
5.5.2.1 PDO:Power_On_And_Reset state description 

A PQI device enters this initial state when the PCI Function enters the DO uninitialized state (see PCI-PM) (e.g., 
upon power on or following a PCI Express reset (see PCIe)). 
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While in this state, the PQI device shall perform internal initialization (e.g., POST) and shall set all register values 
to their default values (see 6.2). 

5.5.2.2 Transition PDO:Power_On_And_Reset to PD1:PQI_Status_Available 

This transition shall occur after the PQI device: 

a) reaches the DO active power management state (see PCI-PM) with the Memory Space Enable bit set to 
one in the Command register (see PCI). 

5.5.3 PD1:PQI_Status_Available state 

5.5.3.1 PD1 :PQI_Status_Available state description 

While in this state the PQI device is initialized by system software (see PCI). 

Upon entry to this state PQI device initialization begins. While in this state: 

a) if an error occurs during PQI device initialization, then: 

A) the PQI device shall set the error code to ERROR DETECTED DURING INITIALIZATION in the PQI 
Device Error register (see 6.2.18); and 

B) the PD state machine transitions as described in 5.5.3.4; 

b) all queues are deleted and their corresponding objects are set to their uninitialized state; 

c) register attributes (see PCIe) are as defined in table 19; and 

d) the PQI device is completing PQI reset. 

5.5.3.2 Transition PD1:PQI_Status_Available to PDO:Power_On_And_Reset 

This transition shall occur if: 

a) the PQI device detects a PCI Express reset. 

5.5.3.3 Transition PD1:PQI_Status_Available to PD2:AII_Registers_Ready 

This transition shall occur if the hold in pdI bit is set to zero in the PQI Device Reset register (see 6.2.20) and 
after: 

a) PQI device internal initialization (e.g., POST) is complete; and 

b) the PQI device is ready to process PD functions (see 6.2.5). 

5.5.3.4 Transition PD1:PQI_Status_Available to PD4:Error 

This transition shall occur if: 

a) an error is detected during PQI device initialization; 

b) an internal error (e.g., device error) is detected; and 

c) an error is detected when completing PQI reset. 

5.5.4 PD2:AII_Registers_Ready state 

5.5.4.1 PD2:AII_Registers_Ready state description 

While in this state: 

a) the PQI device memory space is configured; 

b) the PQI device standard registers are available; 

c) the PQI host may create the administrator queue pair (see 5.3.3.2); 

d) the PQI device shall process the Administrator Queue Configuration Function register function (e.g., 
CREATE ADMINISTRATOR QUEUE PAIR) (see 5.3.3 2); and 

e) if the PQI device detects an error described in table 23, then the PQI shall set the error code as 
described in table 23. 

Register attributes (see PCIe) are as defined in table 19. 
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5.5.4.2 Transition PD2:AII_Registers_Ready to PDO:Power_On_And_Reset 

This transition shall occur if: 

a) the PQI device detects a PCI Express reset. 

5.5.4.3 Transition PD2:AII_Registers_Ready to PD1 iPQI Status Available 

This transition shall occur if: 

a) the PQI device detects a PQI reset (see 5.7). 

5.5.4.4 Transition PD2:AII_Registers_Ready to PD3:Administrator_Queue_Pair_Ready 

This transition shall occur if: 

a) the function and status code field is set to OOh (i.e., IDLE) in the Administrator Queue Configuration 
Function register; and 

b) the administrator queue pair has been successfully created (see 5.3.3.2). 

5.5.4.5 Transition PD2:AII_Registers_Ready to PD4:Error 

This transition shall occur if the PQI device detects: 

a) a reserved code value used in the function and status code field in the Administrator Queue Configu¬ 
ration Function register (see table 23); 

b) an invalid value in the Administrator Queue Parameter register (see 6.2.17); 

c) an administrator queue pair create error (see table 23); 

d) an administrator queue pair delete error (see table 23); 

e) an internal error (e.g., device error); or 

f) the function and status code field is set to 01 h or 02h and the PQI device is already processing a PD 
function (see table 23). 

5.5.5 PD3:Administrator_Queue_Pair_Ready state 

5.5.5.1 PD3:Administrator_Queue_Pair_Ready state description 

While in this state: 

a) the PQI device is initialized; 

b) the PQI device is ready to process any PCI transaction (see PCI-PM); 

c) the PQI device shall process the Administrator Queue Configuration Function register (see 6.2.5) 
function (e.g., DELETE ADMINISTRATOR QUEUE PAIR); 

d) the PQI device shall process administrator lUs using the administrator queue pair; 

e) if the operational IQ and the operational OQ have been created (see 5.3.3.3), then the PQI device shall 
process operational lUs using the operational IQ and the operational OQ; 

f) register attributes (see PCIe) are as defined in table 19; and 

g) if the PQI device detects an error described in table 23, then the PQI shall set the error code as 
described in if the PQI device detects an error described in table 23, then the PQI shall set the error code 
as described in table 23. 

5.5.5.2 Transition PD3:Administrator_Queue_Pair_Ready to PDO:Power_On_And_Reset 

This transition shall occur if: 

a) the PQI device detects a PCI Express reset. 

5.5.5.3 Transition PD3:Administrator_Queue_Pair_Ready to PD1:PQI_Status_Available 

This transition shall occur if: 

a) the PQI device detects a PQI reset. 
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5.5.5.4 Transition PD3:Administrator_Queue_Pair_Ready to PD2:AII_Registers_Ready 

This transition shall occur after: 

a) the PQI device successfully completes deleting the administrator queue pair using the DELETE 
ADMINISTRATOR QUEUE PAIR PD function (see 6.2.5); and 

b) the PQI device sets the function and status code field to OOh (i.e., IDLE) in the Administrator Queue 
Configuration Function register. 

5.5.5.5 Transition PD3:Administrator_Queue_Pair_Ready to PD4:Error 

This transition shall occur if the PQI device detects: 

a) a reserved code value used in the function and status code field in the Administrator Queue 
Configuration Function register (see 6.2.5); 

b) an administrator queue creation (see 5.3.3.2) is initiated by PQI host; 

c) an administrator queue pair delete error (see 5.3.4.2); 

d) an internal error (e.g., device error); 

e) an invalid iu type field (see 9.3) in an inbound IU; 

f) an invalid iu length field (see 9.3) in an inbound IU; 

g) an inbound IU in an operational IQ that specifies an invalid OQ ID (see 5.2.5.12.2); 

h) the function and status code field is set to 01 h or 02h and the PQI device is already processing a PD 
function (see table 23); or 

i) all operational queues have not been deleted and the PQI device receives the delete administrator 
queue pair request (see table 23). 

5.5.6 PD4:Error state 

5.5.6.1 PD4:Error state description 

Upon entry to this state: 

a) the PQI Device Error register indicates the error (see 6.2.18); 

b) all outstanding IU operations are aborted; and 

c) the administrator queue pair, if any, and the operational queues,if any, are in an unknown state. 

If an internal error occurs, then the PQI device shall set the error code to INTERNAL ERROR in the PQI Device 
Error register (see 5.6). 

5.5.6.2 Transition PD4:Errorto PDO:Power_On_And_Reset 

This transition shall occur if: 

a) the PQI device detects a PCI Express reset. 

5.5.6.3 Transition PD4:Error to PD1:PQI_Status_Available 

This transition shall occur if: 

a) the PQI device detects a PQI reset. 
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5.6 Register based error information 

Register based error information indicates error information to the PQI host that is not able to be reported using 
an administrator outbound IU (e.g., the administrator OQ is not available or the administrator OQ is corrupted). 

The register based error information is indicated by the following fields in the PQI Device Error register (see 
6.2.18): 

a) the error code field; 

b) the ERROR CODE qualifier field; 

c) the BYTE pointer field; and 

d) the bit pointer field. 

If more than one error is detected, then the PQI device may report any one of the errors. 

The error details register valid bit in the PQI Device Error register indicates if the error details information is 
available in the PQI Device Error Details register (see 6.2.19). 

Table 18 defines the register based error information. 


Table 18 — Register based error information structure (part 1 of 2) 


Error code 

BYTE POINTER 

field and 

BIT POINTER 

field 

ERROR 

DETAILS 

REGISTER 

VALID bit 

Reference 

ERROR 

CODE 

field 

ERROR 

CODE 

QUALIFIER 

field 

Name 

00 h 

OOh 

NO ERROR 

Invalid 

0 or 1 a 

6.2.18 

01 h to FFh 

Reserved 

01 h 

OOh 

ERROR DETECTED DURING 
INITIALIZATION 

Invalid 

0 or 1 a 

5.5.3.1 

01 h to FFh 

Reserved 

02 h 

OOh 

Reserved 

Olh 

INVALID PD FUNCTION 

Invalid 

0 or 1 a 

6.2.5 

02h 

INVALID PARAMETER FOR PD 
FUNCTION 

Valid 

0 or 1 a 

6.2.17 

03h to FFh 

Reserved 

03h 

OOh 

ERROR CREATING 
ADMINISTRATOR QUEUE PAIR 

Invalid 

0 or 1 a 


Olh 

ERROR DELETING 

ADMINISTRATOR QUEUE PAIR 

Invalid 

0 or 1 a 

5.3.4.2 

02h to FFh 

Reserved 

a If set to one, then the content of the PQI Device Error Details register is vendor specific. 
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Table 18 — Register based error information structure (part 2 of 2) 


Error code 

BYTE POINTER 

field and 

BIT POINTER 

field 

ERROR 

DETAILS 

REGISTER 

VALID bit 

Reference 

ERROR 

CODE 

field 

ERROR 

CODE 

QUALIFIER 

field 

Name 

04 h 

OOh 

Reserved 

Olh 

INVALID IU TYPE IN GENERAL 
ADMIN REQUEST IU 

Invalid 

0 or 1 a 

10.1.2 

02h 

INVALID IU LENGTH IN GENERAL 
ADMIN REQUEST IU 

Invalid 

0 or 1 a 

10.1.2 

03h to FFh 

Reserved 

05h 

OOh 

INTERNAL ERROR 

Invalid 

0 or 1 a 

5.5.6.1 

Olh 

OQ SPANNING CONFLICT 

Invalid 

0 or 1 a 

5.3.2.5.4 

02h to FFh 

Reserved 

06 h 

OOh 

Reserved 

Olh 

ERROR COMPLETING PQI SOFT 
RESET 

Invalid 

0 or 1 a 

5.7.2 

02h 

ERROR COMPLETING PQI FIRM 
RESET 

Invalid 

0 or 1 a 

5.7.3 

03h 

ERROR COMPLETING PQI HARD 
RESET 

Invalid 

0 or 1 a 

5.7.4 

04h to FFh 

Reserved 

07h to 7Fh 

OOh to FFh 

Reserved 

80h to FFh 

OOh to FFh 

Vendor specific 

a If set to one, then the content of the PQI Device Error Details register is vendor specific. 
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5.7 PQI reset 

5.7.1 PQI reset overview 

PQI soft reset (see 5.7.2), PQI firm reset (see 5.7.3), and PQI hard reset (see 5.7.4) allow the PQI host to reset 
the PQI device without accessing the configuration space (see 6.1) of the PQI device. 

The configuration space (see 6.1) of all PQI devices in the PCI Express device shall not be affected by any PQI 
reset. By preserving the configuration space, the PQI host may be able to resume communication with the PQI 
device without the need for the system software (see PCI) to re-scan the PCI bus to determine what PCI devices 
are present following the completion of the PQI reset. 

The PQI host may specify that the PQI device remain in the PD1:PQI_Status_Avai!able state (see 5.5.3) 
following a PQI reset if the hold in pdI bit was set to one in the PQI Device Reset register (see 6.2.20). 

The PQI host should initiate a PQI reset using the following steps: 

1) write to the PQI Device Reset register (see 6.2.20) with the reset action field set to 001b (i.e., RESET), 
with a specific reset type in the reset type field, and the specific option in the hold in pdI bit; 

2) wait for at least 100 ms; 

3) repeatedly read the PQI Device Reset register (see 6.2.20) until: 

A) the RESET ACTION field is set to 010b (i.e., RESET COMPLETED); or 

B) the timeout value indicated by the maximum timeout for pqi device reset field in the PQI Device 
Capability register (see 6.2.6) has expired after step 2); 

4) if the RESET ACTION field is not set to 010b (i.e., RESET COMPLETED), then read the PQI Device Status 
register (see 6.2.10) and report the error in a vendor specific manner; and 

5) if the RESET ACTION field is set to 010b (i.e., RESET COMPLETED), then the PQI reset is completed 
without error. 

If the host set the hold in pdI bit to one as part of invoking the PQI reset, then to request that the PQI device exit 
the PD1:PQI_Status_Available state (see 5.5.3.3), the PQI host should initiate the following steps: 

1) write to the PQI Device Reset register (see 6.2.20) with the reset action field set to 001b (i.e., RESET), 
with the reset type field set to 000b (i.e., NO RESET) and the hold in pdI bit set to zero; 

2) wait for at least 100 ms; 

3) repeatedly read the PQI Device Reset register (see 6.2.20) until: 

A) the RESET ACTION field is set to 010b (i.e., RESET COMPLETED); or 

B) the value indicated by the maximum timeout for pqi device reset field in the PQI Device Capability 
register (see 6.2.6) has expired;read the PQI Device Status register (see 6.2.10), the PQI Device 
Error register (see 6.2.10), and the PQI Device Error Details register (see 6.2.19), and report the 
error in a vendor specific manner; and 

4) if the RESET ACTION field is set to 010b (i.e., RESET COMPLETED), then the PQI reset is completed 
without error. 

5.7.2 PQI soft reset 

A PQI soft reset: 

a) resets the PQI device standard registers for this PQI device (see 6.2.2); 

b) deletes the IU layer (see clause 9 and the IU layer standard) content from only this PQI device; 

c) deletes the administrator queue pair, if any (see 5.3.4.2), for this PQI device; 

d) deletes operational IQs, if any, and operational OQs, if any, as described in 5.3.4.3, for this PQI device; 

e) aborts all administrator functions; and 

f) causes the PD state machine to transition to a known state (see 5.5). 

If the PQI device fails to complete PQI soft reset, then: 

a) the PQI device shall set the error code to ERROR COMPLETING PQI SOFT RESET in the PQI Device 
Error register (see 6.2.18); and 

b) the PD state machine transitions as described in 5.5. 
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5.7.3 PQI firm reset 

A PQI firm reset: 

a) resets the PQI device registers for this PQI device (see 6.2); 

b) deletes the IU layer (see clause 9 and the IU layer standard) content from all PQI devices in the PCI 
Express device; 

c) deletes the administrator queue pair, if any (see 5.3.4.2), for this PQI device; 

d) deletes operational IQs, if any, and operational OQs, if any, as described in 5.3.4.3, for this PQI device; 

e) aborts all administrator functions; and 

f) causes the PD state machine to transition to a known state (see 5.5). 

If the PQI device fails to complete PQI firm reset, then: 

a) the PQI device shall set the error code to ERROR COMPLETING PQI FIRM RESET in the PQI Device 
Error register (see 6.2.18); and 

b) the PD state machine transitions as described in 5.5. 

5.7.4 PQI hard reset 

A PQI hard reset: 

a) resets the PQI device registers (see 6.2) for all PQI devices in the PCI Express device; 

b) deletes the IU layer (see clause 9 and the IU layer standard) content from all PQI devices in the PCI 
Express device; 

c) deletes the administrator queue pair, if any (see 5.3.4.2), for all PQI devices in the PCI Express device; 

d) deletes operational IQs, if any, and operational OQs, if any, as described in 5.3.4.3, for all PQI devices in 
the PCI Express device; 

e) aborts all administrator functions; and 

f) causes the PD state machine to transition to a known state (see 5.5). 

If the PQI device fails to complete PQI hard reset, then: 

a) the PQI device shall set the error code to ERROR COMPLETING PQI HARD RESET in the PQI Device 
Error register (see 6.2.18); and 

b) the PD state machine transitions as described in 5.5. 
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6 PCI Express requirements and PQI device registers 
6.1 PCI Express requirements 

Clause 6 describes information associated with PCI Express configuration to support this standard. 

A PQI device is a kind of PCI function (see PCI). 

A PQI device shall: 

a) be a PCI Express Endpoint (see PCIe) or a Root Complex Integrated Endpoint (see PCIe); 

b) support the Advanced Error Reporting Extended Capability (see PCIe); 

c) not require the use of Virtual Channels (see PCIe) or Traffic Classes (see PCIe) beyond the default VCO/ 
TCO (see PCIe); 

d) support MSI-X (see PCIe); and 

e) use a PCI class code assigned for an IU layer over PQI (see PCI-ID). 

A PQI device that has device-specific registers mapped to its first memory BAR that: 

a) have read side effects; or 

b) do not tolerate write merging (see PCIe), 

shall set the Prefetchable bit (see PCIe) to zero in its first memory BAR. 

A PQI device that has device-specific registers mapped to its first memory BAR that: 

a) do not have read side effects; and 

b) tolerate write merging (see PCIe), 

| shall set the Prefetchable bit (see PCIe) to one in its first memory BAR._A PQI device shall set its first memory 
BAR to at least 512 bytes in size allowing for the PQI device registers plus at one administrator queue pair plus 
up to 126 operational queues (e.g. 63 IQs and 63 OQs). A PQI device should set its first memory BAR it to at 
least 4 KiB in size to match typical CPU page sizes. 

A PQI device may support Advanced Error Reporting Multiple Header Recording (see PCIe). 

If a PQI device is a function in a PCI Multi-Function device that contains more than eight PCI functions (see PCI), 
then the PCI Multi-Function device shall support the Alternative Routing-ID Interpretation (ARI) (see PCIe) (i.e., 
be an ARI Device, support the ARI Capability, and not support Phantom Functions). 

A PQI device shall support the Power Budgeting Extended Capability (see PCIe). 

A PQI device shall support 32-bit memory writes and 64-bit memory writes to PQI device registers, IQ PI 
registers, and OQ Cl registers. 64-bit PQI device registers may be accessed by 32-bit memory writes in any 
order (e.g., offset OOOh followed by offset 004h, or offset 004h followed by offset OOOh). Handling of 8-bit memory 
writes and the 16-bit memory writes is outside the scope of this standard. 

A PQI device shall support zero-length reads (see PCIe), 8-bit memory reads, 16-bit memory reads, 32-bit 
memory reads, and 64-bit memory reads from PQI device registers, IQ PI registers, and OQ Cl registers. 
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6.2 PQI device memory space 

6.2.1 PQI device memory space overview 

PQI device memory space is the memory space described by the PQI device's first PCI memory BAR. 
Figure 34 shows the PQI device memory space. 


First PCI memory BAR with 
contents of PQI device 
memory space address 


Offset OOOh 


(first 256 bytes) 


Offset OFFh 
Offset lOOh 


Maximum offset described 
by the PQI device's first PCI 
memory BAR 


PQI device 
standard registers 
(see 6.2.2) 


PQI device 
assigned registers 
(see 6.2.3) 


Figure 34 — PQI device memory space 

The first 256 bytes of the PQI device memory space contain PQI device standard registers as defined in 6.2.2. 
The bytes after the first 256 bytes of PQI device memory space are defined in 6.2.3. 
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6.2.2 PQI device standard registers 

Table 19 defines the PQI device registers from PQI device memory space offsets OOOh through OFFh (i.e., the 
first 256 bytes). 


Table 19 — PQI device standard registers from offset OOOh to offset OFFh (part 1 of 2) 


Offset 

Size 

(bytes) 

Register name 

Register attribute (see PCIe) a 
based on PD state machine state 

Reference 



PD1 

PD2 

PD3 

PD4 


OOOh 

8 

PQI Device Signature 

RO 

RO 

RO 

RO 

6.2.4 

008h 

8 

Administrator Queue Configuration 
Function 

RO 

RW 

RW 

RO 

6.2.5 

OlOh 

8 

PQI Device Capability 

RO 

RO 

RO 

RO 

6.2.6 

018h 

4 

Legacy INTx Interrupt Status 

RO 

RO 

RO 

RO 

6.2.7 

OlCh 

4 

Legacy INTx Interrupt Mask Set 

RO 

RW 

RW 

RO 

6.2.8 

020h 

4 

Legacy INTx Interrupt Mask Clear 

RO 

RW 

RW 

RO 

6.2.9 

024 h 

28 

RsvdZ 

040 h 

4 

PQI Device Status 

RO 

RO 

RO 

RO 

6.2.10 

044 h 

4 

RsvdZ 

048 h 

8 

Administrator IQ PI Offset 

RO 

RO 

RO 

RO 

6.2.11 

050h 

8 

Administrator OQ Cl Offset 

RO 

RO 

RO 

RO 

6.2.12 

058h 

8 

Administrator IQ Element Array 
Address 

RO 

RW 

RO 

RO 

6.2.13 

060h 

8 

Administrator OQ Element Array 
Address 

RO 

RW 

RO 

RO 

6.2.14 

068h 

8 

Administrator IQ Cl Address 

RO 

RW 

RO 

RO 

6.2.15 

070h 

8 

Administrator OQ PI Address 

RO 

RW 

RO 

RO 

6.2.16 

078h 

4 

Administrator Queue Parameter 

RO 

RW 

RO 

RO 

6.2.17 

07Ch 

4 

RsvdZ 

080h 

4 

PQI Device Error 

RO 

RO 

RO 

RO 

6.2.18 

084 h 

4 

RsvdZ 

Key: 

RW = Memory reads and memory writes are supported (see PCIe). 

RO = Memory read are supported, and memory writes are ignored (see PCIe). 

a Reading any register defined in this table shall not cause any side effects (e.g., change any register 
value). 
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Table 19 — PQI device standard registers from offset OOOh to offset OFFh (part 2 of 2) 


Offset 

Size 

(bytes) 

Register name 

Register attribute (see PCIe) a 
based on PD state machine state 

Reference 

PD1 

PD2 

PD3 

PD4 

088h 

8 

PQI Device Error Details 

RO 

RO 

RO 

RO 

6.2.19 

090h 

4 

PQI Device Reset 

RW 

RW 

RW 

RW 

6.2.20 

094 h 

4 

Power Action 

RO 

RW 

RW 

RO 

6.2.21 

098h 

104 

RsvdZ 

Key: 

RW = Memory reads and memory writes are supported (see PCIe). 

RO = Memory read are supported, and memory writes are ignored (see PCIe). 

a Reading any register defined in this table shall not cause any side effects (e.g., change any register 
value). 


Unless otherwise specified, writes of reserved values to defined fields within defined registers shall be ignored. 


6.2.3 PQI device assigned registers 

The PQI device memory space offset range from lOOh to the maximum offset described by the first PCI memory 
BAR (see figure 34): 

a) shall contain IQ PI registers (see 7.1.2), if any; 

b) shall contain OQ Cl registers (see 7.1.3), if any; 

c) may contain MSI-X Table entries; 

d) may contain MSI-X PBA entries; and 

e) may contain vendor specific registers and vendor specific memory space. 

6.2.4 PQI Device Signature register 

The PQI Device Signature register contains a fixed value. 

The PQI host may read this register to determine that the PQI device is present. 

Register attributes (see PCIe) are as defined in table 19. 

Table 20 defines the PQI Device Signature register. 


Table 20 — PQI Device Signature register 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 

0 

(MSB) 


SIGNATURE (‘PQI DREG’) 

7 

(LSB) 


The signature field contains 8 bytes of ASCII data (see 4.1) set as shown in table 20 (i.e., 
5051_4920_4452_4547h). 
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6.2.5 Administrator Queue Configuration Function register 

The Administrator Queue Configuration Function register is used to perform a PD function and to indicate the 
status of a PD function. 

The PQI device shall set the fields defined in the Administrator Queue Configuration Function register to zero 
after power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 21 defines the Administrator Queue Configuration Function register. 


Table 21 — Administrator Queue Configuration Function register 


Byte\Bit 

7 

1 6 

[ 5 4 3 2 | ' 

10 

0 

FUNCTION AND STATUS CODE 

1 



RsvdZ 






7 






The function and status code field is used to specify the PD function to perform and to indicate the status of a 
PD function being performed. 

Table 22 defines the function and status code field for memory reads. 


Table 22 — function and status code field for memory reads 


Code 

Name 

Description 

00 h 

IDLE 

The PQI device is not processing a PD 
function. 

Olh 

CREATING ADMINISTRATOR QUEUE PAIR 

The PQI device is in the process of creating 
the administrator queue pair (see 5.3.3.2). 

02 h 

DELETING ADMINISTRATOR QUEUE PAIR 

The PQI device is in the process of deleting 
the administrator queue pair (see 5.3.4.2). 

All others 

Reserved 
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Table 23 defines the function and status code field for memory writes. 


Table 23 — function and status code field for memory writes 


Code 

Name 

Description 

00 h 

NOP 

Shall be ignored by the PQI device. 

Olh 

CREATE ADMINISTRATOR QUEUE PAIR 

The PQI device shall create the administrator 
queue pair (see 5.3.3.2). 

02 h 

DELETE ADMINISTRATOR QUEUE PAIR 

The PQI device shall delete the administrator 
queue pair (see 5.3.4.2). 

All others a 

Reserved 

a If the PQI host writes a reserved code value to the function and status code field, then the PQI device 
shall set the error code to INVALID PD FUNCTION in the PQI Device Error register (see 6.2.18). See 

5.5.4.5 and 5.5.5.5 in the PD state machine. 

b If the PQI device is processing a PD function, then the PQI device shall set the error code to INVALID PD 
FUNCTION in the PQI Device Error register. See 5.5.4.5 and 5.5.5.5 in the PD state machine. 
c If the administrator queue pair has not been created and the DELETE ADMINISTRATOR QUEUE PAIR 

PD function is requested, then PQI device shall set the error code to ERROR DELETING 
ADMINISTRATOR QUEUE PAIR in the PQI Device Error register. See 5.5.4.5 in the PD state machine. 
d If the administrator queue pair has already been created and the CREATE ADMINISTRATOR QUEUE 
PAIR PD function is requested, then PQI device shall set the error code to ERROR CREATING 
ADMINISTRATOR QUEUE PAIR in the PQI Device Error register. See 5.5.5.5 in the PD state machine. 
e If all operational queues have not been deleted and the DELETE ADMINISTRATOR QUEUE PAIR PD 
function is requested, then PQI device shall set the error code to ERROR DELETING ADMINISTRATOR 
QUEUE PAIR in the PQI Device Error register. See 5.5.5.5 in the PD state machine. 


6.2.6 PQI Device Capability register 

The PQI Device Capability register indicates the capabilities of the PQI device. 
Register attributes (see PCIe) are as defined in table 19. 
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Table 24 defines the PQI Device Capability register. 


Table 24 — PQI Device Capability register 


Byte\Bit 

7 6 5 4 3 2 1 0 

0 

MAXIMUM ADMINISTRATOR IQ ELEMENTS 

1 

MAXIMUM ADMINISTRATOR OQ ELEMENTS 

2 

ADMINISTRATOR IQ ELEMENT LENGTH 

3 

ADMINISTRATOR OQ ELEMENT LENGTH 

4 

(LSB) 

MAXIMUM TIMEOUT FOR PQI DEVICE RESET 

5 

(MSB) 

6 

RsvdZ 

7 



The maximum administrator IQ elements field indicates the maximum number of administrator IQ elements (see 
5.2.5.3.2) supported by the PQI device. The PQI device shall support at least two administrator IQ elements. 

The maximum administrator OQ elements field indicates the maximum number of administrator OQ elements 
(see 5.2.5.3.2) supported by the PQI device. The PQI device shall support at least two administrator OQ 
elements. 

The administrator IQ element length field indicates the administrator IQ element length (see 5.2.5.3.3) in 
16-byte increments (e.g., 01 h means 16 bytes and FFh means 4 080 bytes). The length shall be greater than or 
equal to the size of the largest administrator inbound IU supported by the PQI device. 

The administrator OQ element length field indicates the administrator OQ element length (see 5.2.5.3.3) in 
16-byte increments (e.g., 01 h means 16 bytes and FFh means 4 080 bytes). The length shall be greater than or 
equal to the size of the largest administrator outbound IU supported by the PQI device. 

The MAXIMUM TIMEOUT for pqi device reset field indicates the timeout value in units of 100 ms for the PQI 
device to complete a PQI reset (see 5.7). 

6.2.7 Legacy INTx Interrupt Status register 

Register attributes (see PCIe) are as defined in table 19. 

Table 25 defines the Legacy INTx Interrupt Status register. 


Table 25 — Legacy INTx Interrupt Status register 


Byte\Bit 

7 | 6 | 5 | 4 | 3 

2 

1 

0 

0 

RsvdZ 

SOURCE 

PENDING 

INTERRUPT 

MASK 

INTERRUPT 

PENDING 

1 

RsvdZ 




3 






A source pending bit set to one indicates that one or more interrupt sources are asserted. A source pending bit 
set to zero indicates that no interrupt source is asserted. 
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An interrupt mask bit set to one indicates that the virtual INTx wire mask is enabled. An interrupt mask bit set 
to zero indicates that the virtual INTx wire mask is disabled. 

An interrupt pending bit set to one indicates that the virtual INTx wire is asserted by the PQI device. An 
interrupt pending bit set to zero indicates that the virtual INTx wire is deasserted by the PQI device. 

The source pending bit and the interrupt pending bit are set to zero after power on, PCI Express reset, or PQI 
reset (see 5.7) as a result of all OQs being deleted. The interrupt mask bit shall be set to zero after power on, 
PCI Express reset, or PQI reset (see 5.7). 

6.2.8 Legacy INTx Interrupt Mask Set register 

The PQI device shall set the fields defined in the Legacy INTx Interrupt Mask Set register to zero at the 
completion of a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 26 defines the Legacy INTx Interrupt Mask Set register. 


Table 26 — Legacy INTx Interrupt Mask Set register 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 

0 

0 

RsvdZ 

INTERRUPT 

MASK SET 

1 

RsvdZ 


3 



For memory writes: 

a) an interrupt mask set bit set to one specifies that the legacy INTx interrupt shall be masked (i.e., the 
virtual INTx wire (see PCIe) shall not be asserted by the PQI device); and 

b) an interrupt mask set bit set to zero shall be ignored. 

For memory reads, the interrupt mask set bit is the same as the interrupt mask bit in Legacy INTx Interrupt 
Status register (see 6.2.7). 

6.2.9 Legacy INTx Interrupt Mask Clear register 

The PQI device shall set the fields defined in the Legacy INTx Interrupt Mask Clear register to zero at the 
completion of a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 27 defines the Legacy INTx Interrupt Mask Clear register. 


Table 27 — Legacy INTx Interrupt Mask Clear register 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 

0 

0 

RsvdZ 

INTERRUPT 

MASK 

CLEAR 

1 

RsvdZ 


3 
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For memory writes: 

a) an interrupt mask clear bit set to one specifies that the legacy INTx interrupt shall be unmasked (i.e., 
the virtual INTx wire may be asserted by the PQI device); and 

b) an interrupt mask clear bit set to zero shall be ignored. 

For memory reads, the interrupt mask clear bit is the same as the interrupt mask bit in Legacy INTx Interrupt 
Status register (see 6.2.7). 

6.2.10 PQI Device Status register 

The PQI Device Status register indicates the status of the PQI device. 

Register attributes (see PCIe) are as defined in table 19. 

Table 28 defines the PQI Device Status register. 


Table 28 — PQI Device Status register 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

RsvdZ 

PQI device state 

1 

RsvdZ 

op iq 

ERROR 

OP OQ 

ERROR 

2 


RsvdZ 


3 




Table 29 defines the pqi device state field. 

Table 29 — pqi device state field 


Code 

PD state machine state a 

Oh 

PDO:Power_On_And_Reset 

1h 

PD1 :PQI_Status_Available 

2h 

PD2:AII_Registers_Ready 

3h 

PD3:Administrator_Queue_Pair_Ready 

4h 

PD4:Error 

All others 

Reserved 

a Refer to section 5.5.1 for the PD state machine. 


The PQI device sets the pqi device state field to Oh (i.e., PDO:Power_On_And_Reset) after power on and PCI 
Express reset. 

The PQI device sets the pqi device state field to 1 h (i.e., PD1 :PQI_Status_Available) after PQI reset completion 
(see 5.7). 

An op iq error bit set to one indicates that the PQI device has stopped consuming from one or more operational 
IQs due to an error. An op iq error bit set to zero indicates that the PQI device has not stopped consuming from 
one or more operational IQs due to an error. If no operational IQ is in error, then the PQI device shall set the op 
iq error bit to zero. 
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An op oq error bit set to one indicates that the PQI device has stopped producing to one or more operational 
OQs due to an error. An op oq error bit set to zero indicates that the PQI device has not stopped producing to 
one or more operational OQs due to an error. If no operational OQ is in error, then the PQI device shall set the op 
oq error bit to zero. 

The op iq error bit and op oq error bit shall be set to zero after power on, PCI Express reset, or PQI reset 
(see 5.7). 

6.2.11 Administrator IQ PI Offset register 

The Administrator IQ PI Offset register is updated during administrator queue pair creation (see 5.3.3.2) and 
during administrator queue pair deletion (see 5.3.4.2). 

The PQI device shall set the fields defined in the Administrator IQ PI Offset register to zero at the completion of a 
power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 30 defines the Administrator IQ PI Offset register. 


Table 30 — Administrator IQ PI Offset register 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

ADMINISTRATOR IQ PI OFFSET 

(MSB) 

(LSB) 

7 



The administrator iq pi offset field indicates the 64-bit offset in PQI device memory space (see 6.2.1) of the 
administrator IQ PI (i.e., the administrator IQ PI address is the address contained in the first PCI memory BAR 
plus the administrator IQ PI offset). The administrator iq pi offset field shall be a multiple of four (i.e, byte 0 bit 
0 set to zero and byte 0 bit 1 set to zero). 

6.2.12 Administrator OQ Cl Offset register 

The Administrator OQ Cl Offset register is updated during administrator queue pair creation (see 5.3.3.2) and 
during administrator queue pair deletion (see 5.3.4.2). 

The PQI device shall set the fields defined in the Administrator OQ Cl Offset register to zero at the completion of 
a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 31 defines the Administrator OQ Cl Offset register. 


Table 31 — Administrator OQ Cl Offset register 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

ADMINISTRATOR OQ Cl OFFSET 

(MSB) 

(LSB) 

7 



The administrator oq ci offset field indicates the 64-bit offset in PQI device memory space (see 6.2.1) of the 
administrator OQ Cl (i.e., the administrator OQ Cl address is the address contained in the first PCI memory BAR 
plus the administrator OQ Cl offset). The administfrator oq ci offset field shall be a multiple of four (i.e, byte 0 
bits 1 to 0 set to 00b). 
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6.2.13 Administrator IQ Element Array Address register 

The Administrator IQ Element Array Address register is updated during administrator queue pair creation (see 
5.3.3.2). 

The PQI device shall set the fields defined in the Administrator IQ Element Array Address register to zero at the 
completion of a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 32 defines the Administrator IQ Element Array Address register. 


Table 32 — Administrator IQ Element Array Address register 


Byte\Bit 

7 6 

5 4 3 2 1 0 

0 

(LSB) 

RsvdZ 

7 

ADMINISTRATOR IQ ELEMENT ARRAY ADDRESS 

(MSB) 


The administrator iq element array address field specifies and indicates the upper 58 bits of the 64-bit 
administrator IQ element array address. The least significant six bits of the 64-bit administrator IQ element array 
address, which are not specified by the administrator iq element array address field, are zero. 

6.2.14 Administrator OQ Element Array Address register 

The Administrator OQ Element Array Address register is updated during administrator queue pair creation (see 
5.3.3.2). 

The PQI device shall set the fields defined in the Administrator OQ Element Array Address register to zero at the 
completion of a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 33 defines the Administrator OQ Element Array Address register. 


Table 33 — Administrator OQ Element Array Address register 


Byte\Bit 

7 6 

5 4 3 2 1 0 

0 

(LSB) 

RsvdZ 

7 

ADMINISTRATOR OQ ELEMENT ARRAY ADDRESS 

(MSB) 


The administrator OQ element array address field specifies and indicates the upper 58 bits of the 64-bit 
administrator OQ element array address (see 6.2.1). The least significant six bits of the 64-bit administrator OQ 
element array address, which are not specified by the administrator oq element array address field, are zero. 

6.2.15 Administrator IQ Cl Address register 

The Administrator IQ Cl Address register is updated during administrator queue pair creation (see 5.3.3.2). 

The PQI device shall set the fields defined in the Administrator IQ Cl Address register to zero at the completion of 
a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 
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Table 34 defines the Administrator IQ Cl Address register. 

Table 34 — Administrator IQ Cl Address register 


Byte\Bit 

7 6 5 4 3 2 

1 0 

0 

(LSB) 

RsvdZ 

7 

ADMINISTRATOR IQ Cl ADDRESS 

(MSB) 


The administrator IQ Cl address field specifies and indicates the upper 62 bits of the 64-bit administrator IQ Cl 
address. The least significant two bits of the 64-bit administrator IQ Cl address, which are not specified by the 
administrator iq ci address field, are zero. 

6.2.16 Administrator OQ PI Address register 

The Administrator OQ PI Address register is updated during administrator queue pair creation (see 5.3.3.2) and 
during administrator queue pair deletion (see 5.3.4.2). 

The PQI device shall set the fields defined in the Administrator OQ PI Address register to zero at the completion 
of a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 

Table 35 defines the Administrator OQ PI Address register. 


Table 35 — Administrator OQ PI Address register 


Byte\Bit 

7 6 5 4 3 2 

1 0 

0 

(LSB) 

RsvdZ 

7 

ADMINISTRATOR OQ PI ADDRESS 

(MSB) 


The administrator OQ pi address field specifies and indicates the upper 62 bits of the 64-bit administrator OQ 
PI address. The least significant two bits of the 64-bit administrator OQ Cl address, which are not specified by 
the administrator oq pi address field, are zero. 

6.2.17 Administrator Queue Parameter register 

The Administrator Queue Parameter register is updated during administrator queue pair creation (see 5.3.3.2). 

The PQI device shall set the fields defined in the Administrator Queue Parameter register to zero at the 
completion of a power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 
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Table 36 defines the Administrator Queue Parameter register. 


Table 36 — Administrator Queue Parameter register 


Byte\Bit 

7 

6 5 4 3 

2 1 0 

0 

NUMBER OF ADMINISTRATOR IQ ELEMENTS 

1 

NUMBER OF ADMINISTRATOR OQ ELEMENTS 

2 

INTERRUPT MESSAGE NUMBER (LSB) 

3 

MSI-X 

DISABLE 

RsvdZ 

(MSB) 


The number of administrator iq elements field specifies and indicates the number of elements in the 
administrator IQ. This field shall be set to: 

a) a value less than or equal to the value contained in the maximum administrator iq elements field in the 
PQI Device Capability register (see 6.2.6); and 

b) at least 02h. 

If the number of ADMINISTF5ATOR iq elements field is set to an invalid value, then the PQI device sets the error 
code to INVALID PARAMETER FOR PD FUNCTION in the PQI Device Error register (see 6.2.18 and 5.5.5.5). 

The number of administrator oq elements field specifies and indicates the number of elements in the 
administrator OQ. This field shall be set to: 

a) a value less than or equal to the value contained in the maximum administrator oq elements field in the 
PQI Device Capability register (see 6.2.6); and 

b) at least 02h. 

If the number of administrator oq elements field is set to an invalid value, then the PQI device sets the error 
code to INVALID PARAMETER FOR PD FUNCTION in the PQI Device Error register (see 6.2.18 and 5.5.5.5). 

The interrupt message number field specifies and indicates the MSI-X Table entry used to generate the 
interrupt message for updates to the administrator OQ PI in MSI-X mode. 

If the interrupt message number field is larger than the MSI-X Table, then the PQI device sets the error code to 
INVALID PARAMETER FOR PD FUNCTION in the PQI Device Error register (see 6.2.18 and 5.5.5.5). 

An msi-x disable bit set to one specifies that the PQI device shall ignore the value in the interrupt message 

number field and shall disable sending the MSI-X interrupt to the PQI host. An msi-x disable bit set to zero 

specifies that the interrupt message number field is valid and that the PQI device shall send the MSI-X interrupt 

to the PQI host as defined in 5.4.2.1. 


6.2.18 PQI Device Error register 

The PQI Device Error register indicates the cause or the source of an error (see 5.6) in the PQI device. The PQI 
Device Error register value is valid while the PD state machine is in the PD4:Error state (see 5.5.6). 

Register attributes (see PCIe) are as defined in table 19. 
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Table 37 defines the PQI Device Error register. 


Table 37 — PQI Device Error register 


Byte\Bit 

7 

6 5 4 

3 2 10 

0 

ERROR CODE 

1 

ERROR CODE QUALIFIER 

2 

BYTE POINTER 

3 

ERROR 

DETAILS 

REGISTER 

VALID 

BIT POINTER 

RsvdZ 


The error code field indicates generic information describing a reported condition (see table 18). 

The error code qualifier field indicates further information (see table 18) related to the condition reported in 
the ERROR CODE field. 

If defined as valid for the error code (see table 18), then the byte pointer field indicates the byte offset in the 
memory space of the PQI device registers described by the first PCI memory BAR that contains the field with the 
invalid value. 

An error details register valid bit set to one indicates that there is valid error specific data (see table 18) in 
the PQI Device Error Details register. An error details register valid bit set to zero indicates that there is no 
valid error specific data in the PQI Device Error Details register (see 6.2.19). 

If defined as valid for the error code (see table 18), the bit pointer field indicates the offset in the PQI device 
register byte of the first bit (i.e., the lowest bit number) containing the field with the invalid value. 

The PQI device shall set the error code field and the error code qualifier field to: 

a) NO ERROR after power on; 

b) NO ERROR after PCI Express reset; or 

c) the error code that indicates the status of the PQI device (see table 18). 

6.2.19 PQI Device Error Details register 

The PQI Device Error Details register is used to describe error details (see 5.6) in combination with the PQI 
Device Error register (see 6.2.18). If the error details register valid bit is set to one in the PQI Device Error 
register, then the PQI Device Error Details register contains valid error details. If the error details register 
valid bit is set to zero in the PQI Device Error register, then the PQI Device Error Details register does not 
contain error details. 

Register attributes (see PCIe) are as defined in table 19. 

Table 38 defines the PQI Device Error Details register. 


Table 38 — PQI Device Error Details register 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

Error details 


7 
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The PQI Device Error Details register value along with the PQI Device Error register value shall be set to the 
values that indicate the error details of the PQI device after power on or after PCI Express reset. 

The PQI Device Error Details register value shall be set to the values that indicate the error details of the PQI 
device after PQI reset (see 5.7). 

6.2.20 PQI Device Reset register 

The PQI Device Reset register is used to initiate a PQI reset (see 5.7) and to provide PQI reset status. 
Register attributes (see PCIe) are as defined in table 19. 

Table 39 defines the PQI Device Reset register. 


Table 39 — PQI Device Reset register 


Byte\Bit 

765 

4 3 

2 10 

0 

RESET ACTION 

RsvdZ 

RESET TYPE 

1 

i-, j-7 hold IN 

RSVClZ 

PDl 

2 

RsvdZ 

3 


Table 40 defines the reset action field for memory writes. 


Table 40 — reset action field for memory writes 


Code 

Name 

Description 

000b 

NO ACTION 

No action. 

001b 

RESET 

Start processing the PQI reset action specified in the reset 
type field. 

All others 

Reserved 


Table 41 defines the reset action field for memory reads. 


Table 41 — reset action field for memory reads 


Code 

Name 

Description 

000b 

NO ACTION 

No reset action has been processed. 

001b 

PROCESSING RESET 

The PQI device is processing the reset action with the reset 
type specified in the reset type field. 

010b 

RESET COMPLETED 

The PQI device has completed the reset action with the reset 
type specified in the reset type field. 

All others 

Reserved 
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The reset action field shall be set to 000b (i.e., NO ACTION) after power on and after PCI Express reset. After 
a PQI reset, the reset action field shall be set to: 

a) 001b (i.e., PROCESSING RESET) if the PQI reset does not successfully complete; or 

b) 010b (i.e., RESET COMPLETED) if the PQI reset successfully completes. 

Table 42 defines the reset type field. 


Table 42 — reset type field 


Code 

Name 

Description 

000b 

NO RESET 

No reset action a 

001b 

SOFT RESET 

PQI soft reset (see 5.7.2) 

010b 

FIRM RESET 

PQI firm reset (see 5.7.3) 

011b 

HARD RESET 

PQI hard reset (see 5.7.4) 

All others 

Reserved 

a The NO RESET reset type allows the PD state machine (see 5.5) to transition from the 

PDI :PQI_Status_Ready state to the PD2:AII_Registers_Ready state after a previous PQI reset was 
performed with the hold in pdI bit set to one (see 5.7.1). 


The reset type field shall be set to 000b (i.e., NO RESET) after power on and after PCI Express reset. After a 
PQI reset, the reset type field shall be set to: 

a) 001b (i.e., SOFT RESET) if the PQI host previously requested a PQI soft reset; 

b) 010b (i.e., FIRM RESET) if the PQI host previously requested a PQI firm reset; or 

c) 011b (i.e., HARD RESET) if the PQI host previously requested a PQI hard reset. 

A hold in pdI bit set to one specifies that the PD state machine remains in the PD1 :PQI_Status_Available state 
(see 5.5.3) following a PQI reset. A hold in pdI bit set to zero specifies that the PD state machine is not held in 
the PD1:PQI_Status_Available state following a PQI reset. 

The PQI device shall set the hold in pdI bit to zero after power on and after PCI Express reset. 

The PQI device shall set the hold in pdI bit to: 

a) zero if the PQI host previously requested a PQI reset with the hold in pdI bit to zero; or 

b) one if the PQI host previously requested a PQI reset with the hold in pdI bit to one. 

6.2.21 PQI Device Power Action register 

The PQI Device Power Action register is used to notify the PQI device about upcoming operating 
system-directed power management transitions and device power state transitions. 

The PQI device shall set the fields defined in PQI Device Power Action register to zero at the completion of a 
power on, PCI Express reset, or PQI reset (see 5.7). 

Register attributes (see PCIe) are as defined in table 19. 
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Table 43 defines the PQI Device Power Action register. 

Table 43 — PQI Device Power Action register 


Byte\Bit 

7 1 6 

5 | 4 | 3 | 2 | 1 | 0 

0 

POWER ACTION 

SYSTEM POWER ACTION 

1 

RsvdZ DEVICE POWER ACTION 

2 

RsvdZ 

3 



Table 44 defines the power action field for memory writes. 

Table 44 — power action field for memory writes 


Code 

Description 

00b 

No action 

01b 

Process the power action specified in the system power action field and the device 
power action field. 

If the PQI device receives a write specifying a different power action while processing a 
previous power action, then the results are vendor specific. 

All others 

Reserved 


Table 45 defines the power action field for memory reads. 

Table 45 — power action field for memory reads 


Code 

Description 

00b 

No power action has been processed. 

01b 

The PQI device is processing the power action indicated in the system power action 
field and the device power action field. 

10b 

The PQI device has completed processing the power action indicated in the system 
power ACTION field and the device power action field. 

11b 

Reserved 
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Table 46 defines the system power action field. 

Table 46 — system power action field 


Code Description 

General notifications (OOh to OFh) 

OOh 

No system power action notification (e.g., system remains in ACPI GO (SO) (see ACPI)) 

Olh 

Operating system is going to shutdown and reboot (e.g., system remains in ACPI GO (SO)) 

02h 

Operating system is going to either: 

a) shutdown and reboot (e.g., system remains in ACPI GO (SO)); or 

b) shutdown and enter ACPI G2 (see ACPI) (i.e., soft off) 

03h to OFh 

Reserved 

Notifications that the system is going to sleep (lOh to IFh) 

lOh 

System is going to enter ACPI G1 (SI, S2, or S3) (see ACPI) (i.e., sleeping) 

11 h 

System is going to enter ACPI G1 (SI) (i.e., sleeping) 

12h 

System is going to enter ACPI G1 (S2) (i.e., sleeping) 

13h 

System is going to enter ACPI G1 (S3) (i.e., sleeping) 

14h 

System is going to enter ACPI G1 (S4) (i.e., hibernating) 

15h 

System is going to enter ACPI G2 (S5) (i.e., soft off) 

16h to IFh 

Reserved 

Notifications that the system is back from sleep (20h to 2Fh) 

20h 

System is back from ACPI G1 (SI, S2, or S3) (i.e., sleeping) 

21h 

System is back from ACPI G1 (SI) (i.e., sleeping) 

22 h 

System is back from ACPI G1 (S2) (i.e., sleeping) 

23h 

System is back from ACPI G1 (S3) (i.e., sleeping) 

24 h 

System is back from ACPI G1 (S4) (i.e., hibernating) 

25h to 2Fh 

Reserved 

Other (30h to 3Fh) 

30h to 3Fh Reserved 
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Table 47 defines the device power action field. 


Table 47 — device power action field 


Code Description 

General notifications (OOh to OFh) 

OOh 

No device power action notification 

01 h to OFh 

Reserved 

Notifications that the device is going to be requested to change device state (lOh to IFh) 

lOh 

System is going to request that the device enter DO (see ACPI and PCI-PM) (i.e., on) 

11 h 

System is going to request that the device enter D1 (see ACPI and PCI-PM) 

12h 

System is going to request that the device enter D2 (see ACPI and PCI-PM) 

13h 

System is going to request that the device enter D3h 0 t or D3 (i.e., off) (see ACPI and PCI-PM) 

14h to IFh 

Reserved 


The PowerState field in the PCI Power Management Capabilities Power Management Control/Status register 
(i.e., PMCSR) (see PCI-PM) is used to set the PQI device to a new device power state (e.g., DO, D1, D2, or 
D3hot) after the device power action notification. 

This standard does not define the specific actions that a PQI device should take to prepare for the specified 
power actions (e.g., flush caches, terminate background tasks, spin down rotating media on a notification that the 
system is going to sleep, or resume background tasks and spin up rotating media if the system is back from 
sleep). 

The PQI device shall continue to process administrator queues and operational queues after being notified of an 
upcoming power action. 


105 


Working Draft PCI Express® Queuing Interface -2 



















| 16 April 2015 


T10/BSR INCUS 507 Revision 01 


7 Queuing layer 

7.1 IQ Cl, IQ PI, OQ Cl, and OQ PI structures 

7.1.1 IQ Cl dword 

An IQ Cl dword is a dword in memory space that contains an IQ Cl (see 5.2.5.7). 
Table 48 defines the structure of the IQ Cl dword. 


Table 48 — IQ Cl dword 


Byte\Bit 

7 

6 

5 

1 4 1 3 1 

2 

1 

1 0 

0 




IQ Cl 



(LSB) 

1 

(MSB) 






2 




Reserved or RsvdZ 




3 








The iq ci field contains the IQ Cl. It is not an error to set the iq ci field to the same value that it already contains. 
Bits that are defined as reserved or RsvdZ are processed as: 

a) RsvdZ if the IQ Cl dword is implemented as a register (e.g., in PQI device memory space); or 

b) reserved if the IQ Cl dword is not implemented as a register (e.g., in PQI host memory space). 

7.1.2 IQ PI register 

An IQ PI register is a register in PQI device memory space that contains an IQ PI (see 5.2.5.7). 

Table 49 defines the structure of the IQ PI register. 


Table 49 — IQ PI register 


Byte\Bit 

7 6 5 4 3 210 

0 

(LSB) 

1 

(MSB) 

2 

RsvdZ 

3 



The iq pi field contains the IQ PI. It is not an error to set the iq pi field to the same value that it already contains. 

7.1.3 OQ Cl register 

An OQ Cl register is a register in PQI device memory space that contains an OQ Cl (see 5.2.5.10). 
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Table 50 defines the structure of the OQ Cl register. 


Table 50 — OQ Cl register 


Byte\Bit 

7 6 5 4 3 2 1 ° 

0 

{LSB) 

1 

(MSB) 

2 

RsvdZ 

3 

REARM 

INTERRUPT 

RsvdZ 


The oq ci field contains the OQ Cl. It is not an error to set the oq ci field to the same value that it already 
contains (e.g., to set the rearm interrupt bit to one). 

When written, a rearm interrupt bit set to: 

a) one specifies that the PQI device shall rearm the interrupt associated with the OQ (see 5.4.2.3); and 

b) zero shall be ignored. 

When read, the PQI device shall return the rearm interrupt bit set to zero. 

7.1.4 OQ PI dword 

An OQ PI dword is a dword in memory space that contains an OQ PI (see 5.2.5.10). 

Table 51 defines the structure of the OQ PI dword. 


Table 51 — OQ PI dword 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 

0 

(LSB) 

1 

(MSB) 

2 

Reserved or RsvdZ 

3 



The oq pi field contains the OQ PI. It is not an error to set the oq pi field to the same value that it already 
contains. 

Bits that are defined as reserved or RsvdZ are processed as: 

a) RsvdZ if the OQ PI dword is implemented as a register (e.g., in PQI device memory space); or 

b) reserved if the OQ Ol dword is not implemented as a register (e.g., in PQI host memory space). 
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8 SGL (scatter gather list) 


8.1 SGL overview 

An SGL is a data structure used to describe a data buffer. A data buffer is either a source data buffer or a 
destination data buffer. An SGL contains one or more SGL segments, ending with a last SGL segment. 

SGL errors are processed using a method defined in the IU layer standard (e.g., SOP). 


8.2 Standard SGL segment and last standard SGL segment 

A standard SGL segment: 

a) is a data structure in a contiguous region of memory space describing all, part, or none of a data buffer 
and the next SGL segment, if any; and 

b) consists of an array of one or more SGL descriptors (see 8.3). 

If the array has more than one SGL descriptor, then each SGL descriptor before to the last SGL descriptor shall 
not be: 

a) a Standard SGL Segment descriptor (see 8.3.4); 

b) a Last Standard SGL Segment descriptor (see 8.3.5); or 

c) a Last Alternative SGL Segment descriptor (see Annex A). 

A last standard SGL segment is a standard SGL segment that does not contain: 

a) a Standard SGL Segment descriptor (see 8.3.4); 

b) a Last Standard SGL Segment descriptor (see 8.3.5); or 

c) a Last Alternative SGL Segment descriptor (see Annex A). 

An SGL shall be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)) if it contains: 

a) a standard SGL segment that contains more than one of the following: 

A) a Standard SGL Segment descriptor; 

B) a Last Standard SGL Segment descriptor; or 

C) a Last Alternative SGL Segment descriptor; 

or 

b) a last standard SGL segment that contains one of the following: 

A) Standard SGL Segment descriptor; 

B) Last Standard SGL Segment descriptor; or 

C) Last Alternative SGL Segment descriptor. 

Table 52 defines the standard SGL segment. 


Table 52 — Standard SGL segment 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 

0 


15 

SGL descriptor [first] (see table 53) 



n -15 


n 

SGL descriptor [last] (see table 53) 
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The standard SGL segment contains one or more SGL descriptors (see 8.3). 

8.3 SGL descriptors 

8.3.1 SGL descriptors overview 

Table 53 defines the SGL descriptor format. 


Table 53 — SGL descriptor format 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 

0 


14 

Descriptor type specific 

15 

sgl descriptor type Descriptor type specific 


The sgl descriptor type field (see table 54) specifies the SGL descriptor type. If the sgl descriptor type field 
is set to a reserved or unsupported value, then the SGL descriptor shall be processed as having an error (see 
10.1.4 and the III layer standard (e.g., SOP)). 


Table 54 — sgl descriptor type field 


Code 

Descriptor 

Reference 

Oh 

Data Block descriptor 

8.3.2 

1h 

Bit Bucket descriptor 

8.3.3 

2h 

Standard SGL Segment descriptor 

8.3.4 

3h 

Last Standard SGL Segment descriptor 

8.3.5 

4h 

Last Alternative SGL Segment descriptor 

Annex A 

Fh 

Vendor specific 

All others 

Reserved 


A SGL descriptor set to all zeros is a Data Block descriptor (see 8.3.2) with the address field set to 
00000000_00000000h and the length field set to OOOOOOOOh and may be used in the SGL to specify no data 
buffer. 

8.3.2 Data Block descriptor 

The Data Block descriptor describes a data block. 
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Table 55 defines the Data Block descriptor. 


Table 55 — Data Block descriptor 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 

0 

(LSB) 


ADDRESS 

7 

(MSB) 

8 

(LSB) 


LENGTH 

11 

(MSB) 

12 



Reserved 

14 


15 

SGL DESCRIPTOR TYPE (Oh) ZERO 


The address field specifies the starting 64-bit memory address of the data block. 

The length field specifies the length in bytes of the data block. A length field set to OOOOOOOOh specifies that no 
data be transferred. A Data Block descriptor specifying that no data be transferred shall not be processed as 
having an error. 

If the value in the address field plus the value in the length field is greater than 1_00000000_00000000h, then 
the Data Block descriptor shall be processed as having an error (see 10.1.4 and the III layer standard (e.g., 
SOP)). 

The zero field shall contain Oh. A Data Block descriptor containing a zero field set to a value other than Oh shall 
be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

The sgl descriptor type field is defined in 8.3.1 and shall be set as shown in table 55 for the Data Block 
descriptor. 

8.3.3 Bit Bucket descriptor 

The Bit Bucket descriptor is used to discard (i.e., skip over) parts of the source data stream if the SGL describes 
a destination data buffer. 
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Table 56 defines the Bit Bucket descriptor. 


Table 56 — Bit Bucket descriptor 


Byte\Bit 

7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 

0 


7 

Reserved 

8 

(LSB) 

11 

LENGTH 

(MSB) 

12 


14 

Reserved 

15 

SGL DESCRIPTOR TYPE (1h) ZERO 


If the SGL describes a destination data buffer, then the length field specifies the number of bytes of the source 
data stream to be discarded (i.e., the number of bytes to not be transferred to the destination data buffer). A 
length field set to OOOOOOOOh specifies that none of the source data stream shall be discarded and shall not be 
processed as having an error. 

If the SGL describes a source data buffer, then the length field shall be ignored. 

The zero field shall contain Oh. A Bit Bucket descriptor containing a zero field set to a value other than Oh shall 
be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

The sgl descriptor type field is defined in 8.3.1 and shall be set as shown in table 56 for the Bit Bucket 
descriptor. 

8.3.4 Standard SGL Segment descriptor 

The Standard SGL Segment descriptor describes the next SGL segment, which is a standard SGL segment (see 
8.2) and may or may not be the last standard SGL segment (see 8.2). 

Table 57 defines the Standard SGL Segment descriptor. 


Table 57 — Standard SGL Segment descriptor 


Byte\Bit 

7 6 5 4 

3 2 10 

0 

(LSB) 

Reserved 


ADDRESS 

7 

(MSB) 


8 


(LSB) 


LENGTH 

11 

(MSB) 


12 




Reserved 

14 



15 

SGL DESCRIPTOR TYPE (2h) 

ZERO 
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The address field specifies the upper 60 bits of the 64-bit memory space address of the next SGL segment, 
which is a standard SGL segment (see 8.2). The least significant four bits of the 64-bit memory space address of 
the next SGL segment, which are not specified by the address field, are zero. 

The length field specifies the length in bytes of the next SGL segment. A length field set to zero or a value that 
is not a multiple of 16 shall be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

If the value in the address field plus the value in the length field is greater than 1_00000000_00000000h, then 
the Standard SGL Segment descriptor shall be processed as having an error (see 10.1.4 and the IU layer 
standard (e.g., SOP)). 

The zero field shall contain Oh. A Standard SGL Segment descriptor containing a zero field set to a value other 
than Oh shall be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

The SGL descriptor type field is defined in 8.3.1 and shall be set as shown in table 57 for the Standard SGL 
Segment descriptor. 

8.3.5 Last Standard SGL Segment descriptor 

The Last Standard SGL Segment descriptor describes the next SGL segment, which is a last standard SGL 
segment (see 8.2). 

Table 58 defines the Last Standard SGL Segment descriptor. 


Table 58 — Last Standard SGL Segment descriptor 


Byte\Bit 

7 6 5 4 

3 | 2 | 1 | 0 

0 

(LSB) 

Reserved 


ADDRESS 

7 

(MSB) 


8 


(LSB) 


LENGTH 

11 

(MSB) 


12 




Reserved 

14 



15 

SGL DESCRIPTOR TYPE (3h) 

ZERO 


The address field specifies the upper 60 bits of the 64-bit memory space address of the next SGL segment, 
which is the last SGL segment and is a standard SGL segment (see 8.2). The least significant four bits of the 
64-bit memory space address of the next SGL segment, which are not specified by the address field, are zero. 

The length field specifies the length in bytes of the SGL segment. A length field set to zero or a value that is 
not a multiple of 16 shall be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

If the value in the address field plus the value in the length field is greater than 1_00000000_00000000h, then 
the Last Standard SGL Segment descriptor shall be processed as having an error (see 10.1.4 and the IU layer 
standard (e.g., SOP)). 

The zero field shall contain Oh. A Last Standard SGL Segment descriptor containing a zero field set to a value 
other than Oh shall be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

The sgl descriptor type field is defined in 8.3.1 and shall be set as shown in table 58 for the Last Standard 
SGL Segment descriptor. 
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9 Common properties for all III layers 

9.1 Overview of common properties for all IU layers 

The PQI circular queue provides the following common III layer properties: 

a) support for Ills that span across multiple elements; and 

b) IU header that is consistent across different IU layers. 

9.2 lUs and elements 

9.2.1 lUs and elements overview 

An IU contains a header (see table 59) followed by information defined by the IU type. 

The size of an IU is defined by the IU length as follows: 

a) if the IU is less than or equal to the size of an element, then the IU is contained within a single element 
(see 9.2.2); 

b) if an IU is larger than the size of an element and lUs that span multiple elements in the circular queue is 
supported, then the IU spans across multiple consecutive elements (see 9.2.3); or 

c) if an IU is larger than the size of an element and lUs that span multiple elements in the circular queue is 
not supported, then the producer shall not place the IU in the circular queue. 

9.2.2 IU contained within a single element 

Figure 35 shows an example of an IU that fits within a single element. 


IU 

IU header; 


Information content 
defined by the IU type 



IU 


element 


Figure 35 — Example of an IU that fits within a single element 
9.2.3 IU that spans multiple elements 

When two or more elements are spanned to form a larger IU, only the first element includes the IU header. PQI 
host should not enqueue an IU greater than n-1 elements, where n is the size of the queue in elements. 
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Figure 36 shows an example of an IU spanning across multiple elements. 



across 

multiple 

elements 


Information content 
defined by the IU type 


element 1 


element n 


Figure 36 — Example of an IU spanning across multiple elements 

The administrator queue pair does not support IU spanning multiple elements. The support of IU spanning 
multiple elements for the operational queue is indicated by the REPORT PQI DEVICE CAPABILITY parameter 
data (see 10.2.2.3). 

9.3 Common IU header for all IU layers 

Table 59 defines the common IU header for all IU layers. 

Byte labels for the IU header are shaded in tables defining lUs. 


Table 59 — Common IU header for all IU layers 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

Restricted for IU layer 

1 

PQI COMPATIBLE FEATURES (Oh) 

Restricted for IU layer 

2 


IU LENGTH 

(LSB) 

3 

(MSB) 
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The restricted for IU layer bits are defined by the IU layer (e.g., for PQI see 10.2.1). 

The pqi compatible features field shall be set to the value shown in table 59. The recipient of the IU shall ignore 
the PQI COMPATIBLE FEATURES field. 

The iu length field contains the number of bytes that follow in the IU (i.e., the iu length field does not include 
the number of bytes in the IU header). 
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10 Administrator Ills and administrator functions 

10.1 IU definition 

10.1.1 IU definition overview 

Table 60 defines the PQI lUs. 


Table 60 — PQI lUs (iu type field) 


Code 

IU 

Minimum 

Queue 

Reference 

length (bytes) 

type 

OOh 

NULL IU 

4 

10 

10.1.3 

Request lUs (01 h to 7Fh) 

01 h to 5Fh 

Reserved 




Administrator request lUs (60h to 6Fh) 

60h 

GENERAL ADMIN REQUEST IU 

64 

1 

10.1.4 

61 h to 6Fh 

Reserved 

Vendor-specific administrator request lUs (70h to 7Fh) 

70h to 7Fh 

Vendor specific 




Response lUs (80h to FFh) 

80h to DFh 

Reserved 




Administrator response lUs (EOh to EFh) 

EOh 

GENERAL ADMIN RESPONSE IU 

64 

0 

10.1.5 

Elhto EFh 

Reserved 

Vendor-specific administrator response lUs (FOh to FFh) 

FOh to FFh 

Vendor specific 




Key: 





1 = inbound queue 

O = outbound queue 

10 = inbound queue and outbound queue 
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10.1.2 Administrator IU header 

Table 61 defines the administrator III header, which is compatible with the common III header defined in 9.3. 


Table 61 —Administrator IU header 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH 

(LSB) 

3 

(MSB) 



The iu type field contains the PQI IU type (see table 60). 

The pqi compatible features field contains bits set aside for new functionality, if any, defined by future versions 
of this standard. 

The PQI compatible features field shall be: 

a) set to the value shown in table 61 for the administrator IU header; and 

b) ignored by the recipient. 

The iu length field contains the number of bytes that follow in the IU. 
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Table 62 defines how a PQI device and a PQI host handle errors in the Administrator III header. 


Table 62 — Administrator IU header error handling 


Administrator IU header problem 

PQI device handling 

PQI host handling 

The iu type field is set to a reserved or 
unsupported value. 

The PQI device shall: 

a) stop consuming from the 
administrator IQ; and 

b) set the error code to 

INVALID IU TYPE IN 
GENERAL ADMIN 
REQUEST IU in the PQI 
Device Error register (see 
6.2.18). 

The PD state machine 
transitions as described in 

5.5.5.5. 

The PQI host should: 

a) stop consuming from the 
administrator OQ; and 

b) delete the administrator 
queue pair. 

The iu length field is set to a supported 
value and either: 

a) the iu length field bits 1 to 0 are not 
set to 00b (i.e., the IU length is not a 
multiple of four); 

b) the iu length field is greater than 
the value indicated in the: 

A) ADMINISTRATOR IQ ELEMENT 
length field in the PQI Device 
Capability register (see 6.2.6) 
for request lUs; or 

B) ADMINISTRATOR OQ ELEMENT 

length field in the PQI Device 
Capability register (see 6.2.6) 
for response lUs; 
or 

c) the iu length field is less than the 
minimum length in bytes specified in 
table 60 minus four. 

The PQI device shall: 

a) stop consuming from the 
administrator IQ; and 

b) set the error code to 

INVALID IU LENGTH IN 
GENERAL ADMIN 
REQUEST IU in the PQI 
Device Error register (see 
6.2.18). 

The PD state machine 
transitions as described in 

5.5.5.5. 

The PQI host should: 

a) stop consuming from the 
administrator OQ; and 

b) delete the administrator 
queue pair. 
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10.1.3 NULL IU 

The NULL IU specifies no operation. 
Table 63 defines the NULL IU. 


Table 63 — NULL IU 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (00h) 

1 

PQI COMPATIBLE features (Oh) Reserved 

2 


IU LENGTH (OOOOh) 

(LSB) 

3 

(MSB) 



The iu type field, the pqi compatible features field, and the iu length field are part of the common IU header 
for all IU layers (see 9.3) and shall be set as shown in table 63 for the NULL IU. 


10.1.4 GENERAL ADMIN REQUEST IU 

A GENERAL ADMIN REQUEST IU contains an administrator function request and is sent by a PQI host to a PQI 
device to deliver that request from a PQI host management application client to a PQI device management 
device server (see 10.2). 

If: 

a) a RsvdC bit or byte is set to a value other than zero in administrator function request in a GENERAL 
ADMIN REQUEST IU; or 

b) a defined field is set to a reserved value or unsupported value in administrator function request in a 
GENERAL ADMIN REQUEST IU after the IU header, 

then the PQI device management device server shall return a GENERAL ADMIN RESPONSE IU with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.1). 
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Table 64 defines the GENERAL ADMIN REQUEST IU. 


Table 64 — GENERAL ADMIN REQUEST IU 


Byte\Bit 

7 6 

5 4 3 2 1 

0 

0 

IU TYPE (60h) 

1 

pqi compatible features (Oh) Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE 

11 






Function specific fields 


43 




44 


DATA-IN BUFFER SIZE (if any), 

(LSB) 



DATA-OUT BUFFER size (if any), or 


47 

(MSB) 

function specific fields 


48 


SGL descriptor (if any) (see table 53) or 
function specific fields 





63 




The iu type field, the pqi compatible features field, and the iu length field are part of the common IU header 
for all IU layers (see 9.3) and shall be set as shown in table 64 for the GENERAL ADMIN REQUEST IU. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The request identifier field specifies a request identifier that the PQI device shall use in the response lUs for 
this request IU. The request identifier allows the PQI host to determine the context for each response IU. The 
PQI device management device server shall check the request identifiers for overlaps with other administrator 
functions being processed. If the PQI device management device server detects an overlap, then the PQI device 
management device server shall: 

a) abort the old administrator function with that request identifier; 

b) terminate the new administrator function with that request identifier; and 

c) return a single GENERAL ADMIN RESPONSE IU with: 

A) the FUNCTION CODE field set to the function code specified in the new GENERAL ADMIN REQUEST 
IU; and 

B) the status field set to OVERLAPPED REQUEST IDENTIFIER ATTEMPTED (see 10.1.5.1). 
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The function code field specifies which administrator function is being requested and is defined in 10.2.1. 

The function specific fields are defined by the specific administrator function being processed. 

The data-in buffer size field, if any, specifies the size in bytes of the Data-In Buffer. The PQI device shall 
terminate transfers to the Data-In Buffer when the number of bytes specified by the data-in buffer size field 
have been transferred or when all available data has been transferred, whichever is less. A data-in buffer size 
field set to zero specifies that no data shall be transferred and is not an error unless otherwise specified for the 
administrator function. If the information being transferred to the Data-In Buffer includes fields containing the 
number of bytes to be transferred in some or all of the data, then the contents of these fields shall not be altered 
to reflect the truncation, if any, that results from an insufficient Data-In Buffer size. 

The data-out buffer size field, if any, specifies the size in bytes of the Data-Out Buffer. A data-out buffer size 
field set to zero specifies that no data shall be transferred and is not an error unless otherwise specified for the 
administrator function. 

The SGL descriptor, if any, contains the first standard SGL segment (see 8.3) of an SGL describing: 

a) for a read administrator function, the Data-In Buffer as a destination data buffer; or 

b) for a write administrator function, the Data-Out Buffer as a source data buffer. 

Table 65 defines the SGL descriptor type support requirements for administrator request lUs. 


Table 65 — SGL descriptor type support requirements for administrator request lUs 


Code 3 

SGL descriptor 

Support 

Reference 

Oh 

Data Block descriptor 

M 

8.3.2 

1h 

Bit Bucket descriptor 

M 

8.3.3 

2h 

Standard SGL Segment descriptor 

M 

8.3.4 

3h 

Last Standard SGL Segment descriptor 

M 

8.3.5 

4h 

Last Alternative SGL Segment descriptor 

O 

Annex A 

Fh 

Vendor specific 

Support key: 

M = 
O = 

Support is mandatory. 

Support is optional. 



3 The REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3) reports the SGL 
descriptor types that are supported by a PQI device. The PQI host management application 
client should only use the mandatory SGL descriptor types until it retrieves the REPORT PQI 
DEVICE CAPABILITY parameter data (e.g., to send the REPORT PQI DEVICE CAPABILITY 
function itself). 


If the PQI device management device server performs reserved field checking on the SGL descriptor contained 
in the IU and a reserved bit or byte in the SGL descriptor is set to a value other than zero, then the PQI device 
management device server shall return a GENERAL ADMIN RESPONSE with the status field set to INVALID 
FIELD IN REQUEST IU (see 10.1.5.1 and 10.1.5.3). 

If the PQI device management device server performs reserved field checking on an SGL descriptor in the SGL 
that is not contained in the IU and a reserved bit or byte in that SGL descriptor is set to a value other than zero, 
then the PQI device management device server shall return a GENERAL ADMIN RESPONSE IU with the 
status field set to DATA BUFFER ERROR (see 10.1.5.1). 

If the PQI device management device server processes an SGL that has an error (see 8.2) or an SGL descriptor 
that has an error (see 8.3 and Annex A), then the PQI device management device server shall return a 
GENERAL ADMIN RESPONSE IU with the status field set to DATA BUFFER ERROR. 

For a read administrator function, if the PQI device management device server transfers fewer bytes than 
specified in the data-in buffer size field, then the PQI device management device server shall return a 
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GENERAL ADMIN RESPONSE IU with the status field set to DATA-IN BUFFER UNDERFLOW (see 10.1.5.1 
and 10.1.5.2). Fora write administrator function, no indication is provided that the PQI device management 
device server transferred fewer bytes than specified in the data-out buffer size field. 

If the PQI device management device server attempts to transfer beyond the length of the Data-In Buffer or 
Data-Out Buffer described by the SGL, then the PQI device management device server shall return a GENERAL 
ADMIN RESPONSE IU with the status field set to DATA BUFFER OVERFLOW (see 10.1.5.1). 

While accessing the Data-In Buffer or Data-Out Buffer, if the PQI device management device server encounters: 

1) a PCI Express error described in table 66, then the PQI device management device server shall return a 
GENERAL ADMIN RESPONSE IU with the status field set to the corresponding value described in 
table 66; 

2) a PCI Express error not described in table 66, then the PQI device management device server shall 
return a GENERAL ADMIN RESPONSE IU with the status field set to PCIE FABRIC ERROR; and 

3) an error that the management server is not able to determine is a PCI Express error or not, then the PQI 
device management device server shall return a GENERAL ADMIN RESPONSE IU with the status field 
set to DATA BUFFER ERROR. 

Table 66 defines the status field values for PCI Express errors while accessing the Data-In Buffer or Data-Out 
Buffer. 

Table 66 — status field values for PCI Express errors that occur while accessing the Data-In Buffer or the 
Data-Out Buffer 


PCI Express error 

status field 

PCI Express completion timeout 

PCIE COMPLETION TIMEOUT 

PCI Express completer abort 

PCIE COMPLETER ABORT 

PCI Express poisoned TLP received 

PCIE POISONED TLP RECEIVED 

PCI Express ECRC check failed 

PCIE ECRC CHECK FAILED 

PCI Express unsupported request 

PCIE UNSUPPORTED REQUEST 

PCI Express ACS violation 

PCIE ACS VIOLATION 

PCI Express TLP prefix blocked 

PCIE TLP PREFIX BLOCKED 


10.1.5 GENERAL ADMIN RESPONSE IU 
10.1.5.1 GENERAL ADMIN RESPONSE IU overview 

A GENERAL ADMIN RESPONSE IU is sent by a PQI device to a PQI host to deliver a response for an 
administrator request IU (see 10.1.1) from a PQI device management device server to a PQI host management 
application client. 
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Table 67 defines the GENERAL ADMIN RESPONSE IU. 

Table 67 — GENERAL ADMIN RESPONSE IU 


Byte\Bit 


IU TYPE (EOh) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE 


15 

16 


Additional status descriptor 


Function specific fields 


The iu type field, the pqi compatible features field, and the iu length field are part of the common IU header 
for all IU layers (see 9.3) and shall be set as shown in table 67 for the GENERAL ADMIN RESPONSE IU. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field indicates the request identifier of the administrator function for which this response 
is being returned. 

The function code field indicates the administrator request for which this response is being returned and is 
defined in 10.2.1. 
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Table 68 defines the status field and additional status descriptor. 

Table 68 — status field and additional status descriptor (part 1 of 2) 


status field 

Additional status 
descriptor 

Code 

Name 

Results indicating administrator function success (OOh to 3Fh) 

OOh 

GOOD 

Reserved 

Olh 

DATA-IN BUFFER UNDERFLOW 

See 10.1.5.2 

02h to 3Fh 

Reserved 

Results indicating administrator function failure (40h to FFh) 

Errors accessing the Data Buffer (40h to 7Fh) 

Miscellaneous errors accessing the Data Buffer (40h to 5Fh) 

40h 

DATA BUFFER ERROR 

Reserved 

41 h 

DATA BUFFER OVERFLOW 

Reserved 

42h to 5Fh 

Reserved 

PCI Express related errors accessing the Data Buffer (60h to 6Fh) 

60h 

PCIE FABRIC ERROR 

Reserved 

61 h 

PCIE COMPLETION TIMEOUT 

Reserved 

62 h 

PCIE COMPLETER ABORT 

Reserved 

63h 

PCIE POISONED TLP RECEIVED 

Reserved 

64 h 

PCIE ECRC CHECK FAILED 

Reserved 

65h 

PCIE UNSUPPORTED REQUEST 

Reserved 

66 h 

PCIE ACS VIOLATION 

Reserved 

67h 

PCIE TLP PREFIX BLOCKED 

Reserved 

68h to 6Fh 

Reserved 

Other errors accessing the Data Buffer (70h to 7Fh) 

70h to 7Fh Reserved 
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Table 68 — status field and additional status descriptor (part 2 of 2) 


status field 

Additional status 
descriptor 

Code 

Name 

Other errors (80h to EFh) 

80 h 

GENERIC ERROR 

Reserved 

81 h 

OVERLAPPED REQUEST IDENTIFIER ATTEMPTED 

Reserved 

82 h 

INVALID FIELD IN REQUEST IU 

See 10.1.5.3 

83h 

INVALID FIELD IN DATA-OUT BUFFER 

See 10.1.5.4 

84h to EFh 

Reserved 

Vendor specific (FOh to FFh) 

FOh to FFh Vendor-specific 


The function specific fields are defined by each administrator function (see 10.2). 

10.1.5.2 Additional status descriptor for status field set to DATA-IN BUFFER UNDERFLOW 

Table 69 defines the additional status descriptor if the status field is set to DATA-IN BUFFER UNDERFLOW 
(see 10.1.5.1). 


Table 69 — Additional status descriptor if the status field is set to DATA-IN BUFFER UNDERFLOW 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

DATA TRANSFERRED 

(MSB) 

(LSB) 

3 



The data transferred field indicates the number of contiguous bytes starting with offset zero in the Data-In 
Buffer that the PQI device management device server transferred. 

10.1.5.3 Additional status descriptor for status field set to INVALID FIELD IN REQUEST IU 

Table 70 defines the additional status descriptor if the status field is set to INVALID FIELD IN REQUEST IU (see 
10.1.5.1). 


Table 70 — Additional status descriptor if the status field is set to INVALID FIELD IN REQUEST IU 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 


BYTE POINTER 

(LSB) 

1 

(MSB) 


2 

Reserved 

3 

Reserved bit pointer Reserved 
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The byte pointer field indicates the offset in the GENERAL ADMIN REQUEST IU of the first byte (i.e., the 
lowest byte number) containing the field with the invalid value. 

The bit pointer field indicates the offset in the byte in the GENERAL ADMIN REQUEST IU pointed to by the 
byte pointer field of the first bit (i.e., the lowest bit number) containing the field with the invalid value. 

10.1.5.4 Additional status descriptor for status field set to INVALID FIELD IN DATA-OUT BUFFER 

Table 71 defines the additional status descriptor if the status field is set to INVALID FIELD IN DATA-OUT 
BUFFER (see 10.1.5.1). 

Table 71 — Additional status descriptor if the status field is set to INVALID FIELD IN DATA-OUT BUFFER 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

BYTE POINTER 

(MSB) 

(LSB) 

2 


3 

Reserved bit pointer Reserved 


The byte pointer field indicates the offset in the Data-Out Buffer of the first byte (i.e., the lowest byte number) 
containing the field with the invalid value. If the byte that was in error is at an offset greater than FF_FFFFh, then 
the byte pointer field shall be set to FF FFFFh and the bit pointer field shall be set to 111b. 

The bit pointer field indicates the offset in the byte of the Data-Out Buffer pointed to by the byte pointer field of 
the first bit (i.e., the lowest bit number) containing the field with the invalid value. 
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10.2 Administrator functions 

10.2.1 Administrator functions overview 

Table 72 defines the administrator functions. 


Table 72 — Administrator functions (function code field) (part 1 of 2) 


Code 

Function 

Description 

Type 

Support 

Reference 

General functions (OOh to OFh) 

OOh 

REPORT PQI DEVICE 
CAPABILITY 

Report PQI device 
capabilities 

R 

M 

10.2.2 

Olh 

REPORT MANUFACTURER 

INFORMATION 

Report PQI device 
manufacturing information 

R 

M 

10.2.3 

02h 

ECHO 

Send an echo command 

N 

O 

10.2.4 

023h to OFh 

Reserved 

Operational queue functions (lOh to IFh) 

lOh 

CREATE OPERATIONAL IQ 

Create an operational IQ 

N 

M 

10.2.5 

11 h 

CREATE OPERATIONAL OQ 

Create an operational OQ 

N 

M 

10.2.6 

12h 

DELETE OPERATIONAL IQ 

Delete an operational IQ 

N 

M 

10.2.7 

13h 

DELETE OPERATIONAL OQ 

Delete an operational OQ 

N 

M 

10.2.8 

14h 

CHANGE OPERATIONAL IQ 
PROPERTIES 

Change properties of an 
operational IQ 

N 

O 

10.2.9 

15h 

CHANGE OPERATIONAL OQ 
PROPERTIES 

Change properties of an 
operational OQ 

N 

O 

10.2.10 

16h 

REPORT OPERATIONAL IQ 
LIST 

Report list of configured 
operational IQs 

R 

M 

10.2.11 

17h 

REPORT OPERATIONAL OQ 
LIST 

Report list of configured 
operational OQs 

R 

M 

10.2.12 

18h 

FREEZE OPERATIONAL IQ 

Freeze a confiaured 

ODerational IQ 

N 

O 

10.2.13 

19h 

UNFREEZE OPERATIONAL 

IQ 

Unfreeze a frozen 

ODerational IQ 

N 

O 

10.2.14 

Key: 

M = Function implementation by the PQI device is mandatory 

O = Function implementation by the PQI device is optional 

R = Read administrator function 

W = Write administrator function 

N = Non-data administrator function 
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Table 72 — Administrator functions (function code field) (part 2 of 2) 


Code 

Function 

Description 

Type 

Support 

Reference 

1Ah 

CONFIGURE IQ 

ARBITRATION 

Confiaure IQ arbitration 

DroDerties 

N 

O 

10.2.15 

ISBhto 

IFh 

Reserved 

Other (20h to DFh) 

20h to DFh 

Reserved 





Vendor specific (EOh to FFh) 

EOh to FFh 

Vendor specific 





Key: 

M = Function implementation by the PQI device is mandatory 

O = Function implementation by the PQI device is optional 

R = Read administrator function 

W = Write administrator function 

N = Non-data administrator function 


10.2.2 REPORT PQI DEVICE CAPABILITY function 
10.2.2.1 REPORT PQI DEVICE CAPABILITY request 

The REPORT PQI DEVICE CAPABILITY function requests that the PQI device management device server 
return information about PQI device capabilities in the Data-In Buffer as defined in 10.2.2.3. 
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Table 73 defines the REPORT PQI DEVICE CAPABILITY request. 

Table 73 — REPORT PQI DEVICE CAPABILITY request 


Byte\Bit 


IU TYPE (60h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


10 

11 


FUNCTION CODE (00h) 


43 

44 


(MSB) 


DATA-IN BUFFER SIZE 


(LSB) 


SGL descriptor (see table 53) 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set to as shown in table 73 for the REPORT PQI DEVICE CAPABILITY request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The REQUEST IDENTIFIER field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and is set to the value shown in table 73 for the REPORT PQI 
DEVICE CAPABILITY request. 

The DATA-IN BUFFER size field is defined in 10.1.4. 

The SGL descriptor is defined in 10.1.4. 


129 


Working Draft PCI Express® Queuing Interface -2 












































| 16 April 2015 


T10/BSR INCUS 507 Revision 01 


10.2.2.2 REPORT PQI DEVICE CAPABILITY response 


Table 74 defines the REPORT PQI DEVICE CAPABILITY response. 


Table 74 — REPORT PQI DEVICE CAPABILITY response 


Byte\Bit 


IU TYPE (EOh) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE (00h) 


15 

16 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 74 for the REPORT PQI DEVICE CAPABILITY response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and is set to the value shown in table 74 for the REPORT PQI 
DEVICE CAPABILITY response. 

The status field and the additional status descriptor are defined in 10.1.5. 


Working Draft PCI Express® Queuing Interface - 2 (PQI-2) 


130 









































| T10/BSR INCUS 507 Revision 01 


16 April 2015 


10.2.2.3 REPORT PQI DEVICE CAPABILITY parameter data 


The format of the parameter data returned in the Data-In Buffer is shown in table 75. 

Table 75 — REPORT PQI DEVICE CAPABILITY parameter data (i.e., Data-In Buffer contents) (part 1 of 2) 


Byte\Bit 

7 

6 5 4 3 

2 1 

0 

0 


PARAMETER DATA LENGTH (023Eh) 

(LSB) 

1 

(MSB) 


2 





Reserved 


4$Z 



Operational IQ capabilities 

8 

IQ ARBITRATION PRIORITY SUPPORT BITMASK 

9 

MAXIMUM AW A 

10 

MAXIMUM AW B 

11 

MAXIMUM AW C 

12 

IQA 

Reserved 

MAXIMUM ARBITRATION BURST 

13 

14 

Reserved 

15 

Reserved 

10- 

FREEZE 

16 


MAXIMUM OPERATIONAL IQS 

(LSB) 

17 

(MSB) 


18 


MAXIMUM OPERATIONAL IQ ELEMENTS 

(LSB) 

19 

(MSB) 


20 

Reserved 


23 


24 


MAXIMUM OPERATIONAL IQ ELEMENT LENGTH 

(LSB) 

25 

(MSB) 


26 


MINIMUM OPERATIONAL IQ ELEMENT LENGTH 

(LSB) 

27 

(MSB) 


Operational OQ capabilities 

28 Reserved cic 


131 Working Draft PCI Express® Queuing Interface - 2 































































| 16 April 2015 


T10/BSR INCUS 507 Revision 01 


Table 75 — REPORT PQI DEVICE CAPABILITY parameter data (i.e., Data-In Buffer contents) (part 2 of 2) 


Byte\Bit 7 6 5 4 3 2 1 0 


29 

Reserved 

30 

(LSB) 

31 

(MSB) 

32 

(LSB) 

33 

(MSB) 

34 

(LSB) 

35 

(MSB) 

36 

(LSB) 

37 

(MSB) 

38 

(LSB) 

39 

(MSB) 

Other parameters 

40 


43 

Reserved 

44 


47 

OPERATIONAL QUEUE PROTOCOL SUPPORT BITMASK 

48 

ADMINISTRATOR SGL DESCRIPTOR TYPE SUPPORT BITMASK 

49 


50 


63 

Reserved 

IU layer specific descriptor list 

64 


79 

IU layer specific descriptor [first] (see table 76) 



560 


575 

IU layer specific descriptor [last] (see table 76) 
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The parameter data length field indicates the number of bytes that follow and shall be set as shown in table 75 
for the REPORT PQI DEVICE CAPABILITY parameter data. 

The iq arbitration priority support bitmask field indicates the IQ arbitration priorities supported by the PQI 

device (see 5.3.5). A bit set to one indicates that the corresponding arbitration priority is supported. A bit set to 

zero indicates that the corresponding arbitration priority is not supported. The bits are defined as follows: 

a) the first bit (i.e., byte 20 bit 0) corresponds to vendor specific: 

b) the second bit (i.e., byte 20 bit 1) corresponds to medium priority: 

c) the third bit (i.e., byte 20 bit 2) corresponds to weighted round robin A: 

d) the fourth bit (i.e., byte 20 bit 3) corresponds to weighted round robin B: 

e) the fifth bit (i.e., byte 20 bit 4) corresponds to weighted round robin C: and 

f) all other bits in this field are reserved. 

The maximum aw A field indicates the maximum weight value in number of elements that is supported by IQ 

arbitration for the weighted round robin A arbitration priority (see 5.3.5). 

The maximum aw B field indicates the maximum weight value in number of elements that is supported by IQ 

arbitration for the weighted round robin B arbitration priority (see 5.3.5). 

The maximum aw c field indicates the maximum weight value in number of elements that is supported by IQ 

arbitration for the weighted round robin C arbitration priority (see 5.3.5). 

The maximum arbitration burst field specifies the maximum number of elements consumed from an IQ that is 

using round robin or weighted round robin arbitration (see 5.3.5). This value is specified as 2 -. A value of 111b 

indicates no limit. 

An IQ arbitration (iqa) bit set to one indicates that the PQI device supports the IQ arbitartion priority functionality 

(see 5.3.5) and the maximum aw a field, the maximum aw b field, the maximum aw c field and the maximum 

arbitration burst field are valid. An IQ arbitration (iqa) bit set to zero indicates that the PQI device does not 

support the IQ arbitartion priority functionality, and the maximum aw a field, the maximum aw b field, the maximum 

aw c field and the maximum arbitration burst field are ignored. 

An iq freeze bit set to one indicates that the PQI device supports the reguest to freeze the operational IQ (see 

10.2.13). An iq freeze bit set to zero indicates that the PQI device does not support the reguest to freeze the 

operational IQ. 

The maximum operational iqs field indicates the maximum number of operational IQs supported by the PQI 
device. 

The maximum operational iq elements field indicates the maximum number of elements in each of the 
operational IQs supported by the PQI device. The maximum operational iq elements field shall be set to a value 
greater than 0001 h. 

The maximum operational iq element length field indicates the maximum length of each operational IQ 
element in 16-byte increments (e.g., 0001 h means 16 bytes and OOFFh means 4 080 bytes). The maximum 
operational iq element length field shall be greater than or equal to the minimum operational oq element 
length field. 

The minimum operational iq element length field indicates the minimum length of each operational IQ element 
in 16-byte increments (e.g., 0001 h means 16 bytes and OOFFh means 4 080 bytes) supported by the PQI device. 
The minimum operational iq element length field shall not be set to OOOOh. 

A common interrupt coalescing (cic) bit set to one indicates that the PQI device manages the values of the 
Coalescing Count attribute (see 5.2.5.12.10), the Minimum Coalescing Time attribute (see 5.2.5.12.8), the 
Maximum Coalescing Time attribute (see 5.2.5.12.9), and the Wait For Rearm attribute (see 5.2.5.12.11), such 
that: 

a) the Coalescing Count attribute is the same value for all operational OQs; 

b) the Minimum Coalescing Time attribute is the same value for all operational OQs; 

c) the Maximum Coalescing Time attribute is the same value for all operational OQs; and 

d) the Wait For Rearm attribute is the same value for all operational OQs. 
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A cic bit set to zero indicates: 

a) the Coalescing Count attribute may be a different value for each operational OQ; 

b) the Minimum Coalescing Time attribute may be a different value for each operational OQ; 

c) the Maximum Coalescing Time attribute may be a different value for each operational OQ; and 

d) the Wait For Rearm attribute may be a different value for each operational OQ. 

The maximum operational oos field indicates the maximum number of operational OQs supported by the PQI 
device. 

The maximum operational OQ elements field indicates the maximum number of elements in each of the 
operational OQs supported by the PQI device. The maximum operational oq elements field shall be set to a 
value greater than 0001 h. 

An interrupt coalescing time granularity field indicates the granularity supported for the coalescing timers 
(see 10.2.6.1) in 100 ns intervals. An interrupt coalescing time granularity field shall not be set to OOOOh. 

The MAXIMUM operational oq element length field indicates the maximum length of each operational OQ 
element in 16-byte increments (e.g., 0001 h means 16 bytes and OOFFh means 4 080 bytes) supported by the 
PQI device. The maximum operational oq element length field shall be greater than or equal to the minimum 

OPERATIONAL OQ ELEMENT LENGTH field. 

The minimum operational oq element length field indicates the minimum length of each operational OQ 
element in 16-byte increments (e.g., 0001 h means 16 bytes and OOFFh means 4 080 bytes) supported by the 
PQI device. The minimum operational oq element length field shall not be set to OOOOh. 

The operational queue protocol support bitmask field indicates the operational queue protocols (see table 
83) that are supported by the PQI device. A bit set to one indicates that the corresponding operational queue 
protocol is supported. A bit set to zero indicates that the corresponding operational queue protocol is not 
supported. The first bit (i.e., byte 44 bit 0) corresponds to an operational queue protocol of OOh (i.e., SOP); the 
last bit (i.e., byte 47 bit 7) corresponds to an operational queue protocol of IFh (i.e., vendor specific). 

The administrator sgl descriptor type support bitmask field indicates the SGL descriptor types (see table 
54) that are supported by the PQI device for administrator request lUs. A bit set to one indicates that the 
corresponding SGL descriptor type is supported. A bit set to zero indicates that the corresponding SGL 
descriptor type is not supported. The first bit (i.e., byte 48 bit 0) corresponds to an SGL descriptor type of Oh (i.e., 
the Data Block descriptor); the last bit (i.e., byte 49 bit 7) corresponds to an SGL descriptor type of Fh. Bits 3 to 0 
represent the mandatory SGL descriptor types for administrator lUs (see table 65) and shall be set to 1111b. 

The SGL descriptor type support bitmask for other IU layers (e.g., SOP) is not defined in this standard. 

The IU layer specific descriptor (see table 76) specifies the additional features supported by the operational 
queue protocol. The first IU layer specific descriptor corresponds to an operational queue protocol of OOh (i.e., 
SOP) and the last (i.e., the 32nd) IU layer specific descriptor corresponds to an operational queue protocol of 
IFh (i e., vendor specific). 
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Table 76 — IU layer specific descriptor 


Byte\Bit 

7 6 5 4 3 2 1 

0 

0 

Reserved 

INBOUND 

SPANNING 

1 

Reserved 


5 


6 

(LSB) 

MAXIMUM INBOUND IU LENGTH 

7 

(MSB) 

8 

Reserved 

OUTBOUND 

SPANNING 

9 

Reserved 


13 


14 

(LSB) 

MAXIMUM OUTBOUND IU LENGTH 

15 

(MSB) 


An inbound spanning bit set to one indicates that the IU layer (e.g., SOP) supports spanning an inbound IU 
across multiple elements. An inbound spanning bit set to zero indicates that the IU layer (e.g., SOP) does not 
support spanning an inbound IU across multiple elements. 

The maximum inbound iu length field indicates the maximum number of bytes in an inbound IU supported by the 
IU layer. 

An outbound spanning bit set to one indicates that the IU layer (e.g., SOP) supports spanning an outbound IU 
across multiple elements. An outbound spanning bit set to zero indicates that the IU layer (e.g., SOP) does not 
support spanning an outbound IU across multiple elements. 

The maximum outbound iu length field indicates the maximum number of bytes in an outbound IU supported by 
the IU layer. 

For each of the IU layer specific descriptors, if the PQI device does not support the operational queue protocol, 
the PQI device shall set: 

a) the inbound spanning bit to zero; 

b) the maximum inbound iu length field to zero; 

c) the outbound spanning bit to zero; and 

d) the maximum outbound iu length field to zero. 
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10.2.3 REPORT MANUFACTURER INFORMATION function 
10.2.3.1 REPORT MANUFACTURER INFORMATION request 

The REPORT MANUFACTURER INFORMATION function requests that the PQI device management device 
server return information about the PQI device manufacturer in the Data-In Buffer as defined in 10.2.3.3. 

Table 77 defines the REPORT MANUFACTURER INFORMATION request. 


Table 77 — REPORT MANUFACTURER INFORMATION request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (01 h) 

11 

RsvdC 


43 


44 

DATA-IN BUFFER SIZE 

(MSB) 

(LSB) 

47 


48 

SGL descriptor (see table 53) 


63 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 77 for the REPORT MANUFACTURER INFORMATION request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The request identifier field is defined in 10.1.4. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 77 for the REPORT 
MANUFACTURER INFORMATION request. 
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The data-in buffer size field is defined in 10.1.4. 
The SGL descriptor is defined in 10.1.4. 


10.2.3.2 REPORT MANUFACTURER INFORMATION response 

Table 78 defines the REPORT MANUFACTURER INFORMATION response. 

Table 78 — REPORT MANUFACTURER INFORMATION response 


Byte\Bit 


IU TYPE (E0h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE (01 h) 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 78 for the REPORT MANUFACTURER INFORMATION response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The REQUEST identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and shall be set as shown in table 78 for the REPORT 
MANUFACTURER INFORMATION response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.3.3 REPORT MANUFACTURER INFORMATION parameter data 

Table 79 defines the REPORT MANUFACTURER INFORMATION parameter data. 

Table 79 — REPORT MANUFACTURER INFORMATION parameter data (i.e., Data-In Buffer contents) 
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The parameter data length field indicates the number of bytes that follow and shall be set as shown in table 79. 

The pci vendor id field indicates the identification of the manufacturer of the PCI device and shall be identical to 
the Vendor ID field in configuration space (see PCI). 

The pci device id field indicates the identification of the PCI device allocated by the PCI device manufacturer and 
shall be identical to the Device ID field in configuration space (see PCI). 

The pci revision id field indicates the revision of the PCI device allocated by the PCI device manufacturer and 
shall be identical to the Revision ID field in configuration space (see PCI). 

The pci class code field indicates the identification of the generic function and register level programming 
interface of the PCI device defined by PCI-ID and shall be identical to the Class Code field in configuration space 
(see PCI). 

The pci subsystem vendor id field indicates the manufacturer of the add-in card or subsystem containing the 
PCI device and shall be identical to the Subsystem Vendor ID field in configuration space (see PCI). 

The pci subsystem id field indicates the identification of the add-in card or subsystem identification allocated by 
the subsystem manufacturer used to identify the add-in card or subsystem where the PCI device resides and 
shall be identical to the Subsystem ID field in configuration space (see PCI). 

The product serial number field indicates ASCII data (see 4.1) that is a manufacturer defined serial number. If 
the product serial number is not available, then the product serial number field shall contain ASCII spaces 
(20h). 

The TlO vendor identification field indicates eight bytes of left-aligned ASCII data (see 4.1) identifying the 
manufacturer of the PQI device. The T10 vendor identification shall be one assigned by INCITS. A list of 
assigned T10 vendor identifications is defined in SPC-4 and on the T10 web site (http://www.t10.org). 

The product identification field indicates sixteen bytes of left-aligned ASCII product identification data (see 
4.1) defined by the manufacturer. 

The product revision level field indicates sixteen bytes of left-aligned ASCII product revision level data (see 
4.1) defined by the manufacturer. 

10.2.4 Echo function 

10.2.4.1 ECHO request 

The ECHO function requests that the PQI device respond with an ECHO response containing the data payload 

specified in the ECHO request. 
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Table 80 defines the ECHO request. 


Table 80 — ECHO request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

Q 

0 

IU TYPE (60ht 

1 

PQI COMPATIBLE FEATURES tOht 

Reserved 

2 


IU LENGTH (003Ch1 


(LSBt 

3 

(MSB) 



4 


Reserved 



5 




6 






7 


VVURr\ MrxtZM 



8 





(LSBt 

9 

(MSB) 

1 1L/QIN 1 IrlCrx 



10 

FUNCTION CODE (02h1 

11 








RsvdC 



15 






16 








DATA PAYLOAD 



47 






48 








RsvdC 



63 







The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 

set to as shown in table 80 for the ECHO request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The REQUEST identifier field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and is set to the value shown in table 80 for the ECHO request. 

The data payload field contains the data to be returned in the ECHO response. 
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10.2.4.2 ECHO response 


Table 81 defines the ECHO response. 


Table 81 — ECHO response 


6 

5 

4 

3 

2 

1 


Byte\Bit 


IU TYPE (EOht 


PQI COMPATIBLE FEATURES (Oh) 


2 


IU LENGTH (003Cht 

(LSB) 

3 

(MSBt 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSBt 


10 

FUNCTION CODE ttbat 

11 

STATUS 

12 






Reserved 


15 




16 






DATA PAYLOAD 


47 




48 






Reserved 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 

set as shown in table 81 for the ECHO response. 

The work area field mav be set to any value by the PQI device and should be ignored bv the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and is set to the value shown in table 81 for the ECHO response. 

The status field and the additional status descriptor are defined in 10.1.5. 

The data payload field contains the data pavload that was specified in the ECHO request. 
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10.2.5 CREATE OPERATIONAL IQ function 
10.2.5.1 CREATE OPERATIONAL IQ request 

The CREATE OPERATIONAL IQ function requests that the PQI device management device server create a new 
operational IQ. 

Table 82 defines the CREATE OPERATIONAL IQ request. 


Table 82 — CREATE OPERATIONAL IQ request (part 1 of 2) 


Byte\Bit 

7 6 5 4 3 210 

0 

IU TYPE (60h) 

1 

PQI compatible features (Oh) Reserved 

2 

(LSB) 

3 

(MSB) 

2 


3 


6 


7 


8 

(LSB) 

REQUEST IDENTIFIER 

9 

(MSB) 

10 

FUNCTION CODE (10h) 

11 

RsvdC 

12 

(LSB) 

13 

(MSB) 

14 

RsvdC 

15 


16 

(LSB) RsvdC 

23 

IQ ELEMENT ARRAY ADDRESS 

(MSB) 

24 

(LSB) RsvdC 

31 

IQ Cl ADDRESS 

(MSB) 

32 

(LSB) 

NUMBER OF ELEMENTS 

33 

(MSB) 

34 

(LSB) 

ELEMENT LENGTH 

35 

(MSB) 
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Table 82 — CREATE OPERATIONAL IQ request (part 2 of 2) 


Byte\Bit 

765 

O 

CM 

CO 

36 

Reserved 

OPERATIONAL QUEUE PROTOCOL 

37 

Reserved arbitration priority 

37-38 




RsvdC 

59 


60 




Vendor specific 

63 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 82 for the CREATE OPERATIONAL IQ request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The REQUEST identifier field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and shall be set as shown in table 82 for the CREATE 
OPERATIONAL IQ request. 

The iq id field specifies the IQ ID (see 5.2.5.9.2) to be assigned to the operational IQ. If: 

a) the iq id field is set to OOOOh; 

b) the iq id field is set to a value that is already assigned to an operational IQ; or 

c) the iq id field is set to a value greater than the maximum opefrational iqs field in the REPORT PQI 

DEVICE CAPABILITY parameter data (see 10.2.2.3), 

then the PQI device management device server shall return a CREATE OPERATIONAL IQ response with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.1 and 10.1.5.3). 

The iq element array address field specifies the upper 58 bits of the 64-bit operational IQ element array 
address (see 5.3.2.1). The least significant six bits of the 64-bit operational IQ element array address, which are 
not specified by the iq element array address field, are zero. 

The iq Cl address field specifies the upper 62 bits of the 64-bit operational IQ Cl address (see 5.2.5.9.7). The 
least significant two bits of the 64-bit operational IQ Cl address, which are not specified by the iq ci address 
field, are zero. 

The number of elements field specifies the number of elements in the operational IQ element array (see 
5.2.5.9.5). If: 

a) the number of elements field is set to a value less than 0002h; or 

b) the NUMBER OF elements field is set to a value greater than the maximum operational iq elements field 
in the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3), 

then the PQI device management device server shall return a CREATE OPERATIONAL IQ response with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.1 and 10.1.5.3). 

The element length field specifies the element length in 16-byte increments (e.g., a value of 0001 h in the 
element length field specifies an element length of 16 bytes). If the element length field is set to a value: 

a) less than the minimum operational iq element length field in the REPORT PQI DEVICE CAPABILITY 
parameter data (see 10.2.2.3); or 

b) greater than the maximum opeirational iq element length field in the REPORT PQI DEVICE 
CAPABILITY parameter data, 
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then the PQI device management device server shall return a CREATE OPERATIONAL IQ response with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.1 and 10.1.5.3). 

The operational queue protocol (see table 83) specifies the operational queue protocol (i.e., IU layer) used 
by the operational IQ (see 5.3.1). 


Table 83 — operational queue protocol field 


Code 

Operational queue protocol (i.e., IU layer) 

Reference 

OOh 

SOP 

SOP 

OlhtoOFh 

Reserved 

10h to IFh 

Vendor specific 


The arbitration priority field specifies the arbitration priority with which the IQ is associated (see 5.3.5t and is 

defined in table 84. 


Table 84 — arbitration priority field 


Code 

Arbitration orioritv 

OOh 

Vendor specific 

01 h 

Medium Drioritv 

02 h 

Weiahted round robin A 

03h 

Weiahted round robin B 

04 h 

Weiahted round robin C 

Others 

Reserved 
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10.2.5.2 CREATE OPERATIONAL IQ response 


Table 85 defines the CREATE OPERATIONAL IQ response. 


Table 85 — CREATE OPERATIONAL IQ response 


Byte\Bit 


IU TYPE (EOh) 


PQI COMPATIBLE FEATURES (Oh) 


(LSB) 


3 

(MSB) 

IU LENGTH (003Ch) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (10h) 

11 

STATUS 

12 






Additional status descriptor 


15 




16 



(LSB) 



IQ PI OFFSET 


23 

(MSB) 



24 






Reserved 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 85 for the CREATE OPERATIONAL IQ response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 85 for the CREATE 
OPERATIONAL IQ response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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If the status field is set to GOOD (see 10.1.5.1), then: 

a) the iq pi offset field indicates the offset in PQI device memory space of the operational IQ PI (i.e., the 
IQ PI address is the memory address contained in the first PCI memory BAR plus the iq pi offset field); 
and 

b) the iq pi offset field shall be a multiple of four (i.e, byte 0 bit 0 set to zero and byte 0 bit 1 set to zero). 
If the status field is not set to GOOD, then the iq pi offset field is invalid. 
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10.2.6 CREATE OPERATIONAL OQ function 
10.2.6.1 CREATE OPERATIONAL OQ request 

The CREATE OPERATIONAL OQ function requests that the PQI device management device server create a 
new operational OQ. 

Table 86 defines the CREATE OPERATIONAL OQ request. 


Table 86 — CREATE OPERATIONAL OQ request (part 1 of 2) 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (11 h) 

11 

RsvdC 

12 


OQ ID 

(LSB) 

13 

(MSB) 


14 


RsvdC 


15 



16 

(MSB) 

(LSB) RsvdC 

23 

OQ ELEMENT ARRAY ADDRESS 

24 

OQ PI ADDRESS 

(MSB) 

(LSB) RsvdC 

31 


32 


NUMBER OF ELEMENTS 

(LSB) 

33 

(MSB) 
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The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 86 for the CREATE OPERATIONAL OQ request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The request identifier field is defined in 10.1.4. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 86 for the CREATE 
OPERATIONAL OQ request. 

The oq id field specifies the OQ ID to be assigned to the operational OQ. If: 

a) the OQ id field is set to OOOOh; 

b) the oq id field is set to a value that is already assigned to an operational OQ; or 

c) the oq id field is set to a value greater than the maximum operational oqs field in the REPORT PQI 

DEVICE CAPABILITY parameter data (see 10.2.2.3), 
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then the PQI device management device server shall return a CREATE OPERATIONAL OQ response with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

The OQ element array address field specifies the upper 58 bits of the 64-bit operational OQ element array 
address (see 5.3.2.1). The least significant six bits of the 64-bit operational OQ element array address, which are 
not specified by the oq element array address field, are zero. 

The oq pi address field specifies the upper 62 bits of the 64-bit operational OQ PI address (see 5.3.3). The least 
significant two bits of the 64-bit operational OQ Cl address, which are not specified by the oq pi address field, 
are zero. 

The number of elements field specifies the number of elements in the operational OQ element array (see 5.3.3). 
If: 

a) the number of elements field is set to a value less than 0002h; or 

b) the number of elements field is set to a value greater than the maximum operational oq elements field 
in the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3), 

then the PQI device management device server shall return a CREATE OPERATIONAL OQ response with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

The element length field specifies the element length in 16-byte increments (e.g., a value of 0001 h in the 
element length field specifies an element length of 16 bytes). If the element length field is set to a value: 

a) less than the minimum operational oq element length field in the REPORT PQI DEVICE CAPABILITY 
parameter data (see 10.2.2.3); or 

b) greater than the maximum operational oq element length field in the REPORT PQI DEVICE 
CAPABILITY parameter data, 

then the PQI device management device server shall return a CREATE OPERATIONAL OQ response with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

The operational queue protocol field (see table 83) specifies the operational queue protocol used by the 
operational OQ (see 5.3.1). 

The interrupt message number field specifies the MSI-X Table entry used to generate the interrupt message for 
operational OQ PI updates in MSI-X mode (see 5.4.2). Th i s f iel d i s not us e d in le gacy I NTx mod e (s ee 5.1.3) or 
po lle d mod e (s ee bAA) . If the interrupt message number field is set to value greater than the Table Size field in 
the Message Control register in the MSI-X Capability Structure (see PCI), then the PQI device management 
device server shall return a CREATE OPERATIONAL OQ response with the status field set to INVALID FIELD 
IN REQUEST IU (see 10.1.5.3). 

NOTE 10 - The Table Size field is 11 bits, therefore the maximum interrupt message number that the PQI device 
is capable of supporting is less than or equal to 2 047. 

An msi-x disable bit set to one specifies that the PQI device shall ignore the value in the interrupt message 

number field and shall disable sending the MSI-X interrupt to the PQI host. An msi-x disable bit set to zero 

specifies that the interrupt message number field is valid and that the PQI device shall send the MSI-X interrupt 

to the PQI host as defined in 5.4.2.1 

The WAIT FOR REARM bit, the COALESCING count field, the MINIMUM COALESCING time field, and the MAXIMUM 
coalescing time field are used for controlling interrupt coalescing in MSI-X mode (see 5.4.2). 

If: 


a) the cic bit is set to one in the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3); 

b) one or more operational OQs already exist; and 

c) one or more of the following conditions is true: 

A) the coalescing count field is set to a value that is not already in use for the Coalescing Count 
attribute by the existing operational OQs; 

B) the minimum coalescing time field is set to a value that is not already in use for the Minimum 
Coalescing Time attribute by the existing operational OQs; 

C) the maximum coalescing time field is set to a value that is not already in use for the Maximum 
Coalescing Time attribute by the existing operational OQs; or 


Working Draft PCI Express® Queuing Interface -2 









| 16 April 2015 


T10/BSR INCUS 507 Revision 01 


D) the wait for rearm bit is set to a value that is not equal to the value of the Wait For Rearm attribute 
for the existing operational OQs, 

then the PQI device management device server shall return a CREATE OPERATIONAL OQ response with the 
status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

A wait for rearm bit set to one specifies that the interrupt coalescing timer is reset and started upon receipt of 
the rearm interrupt bit set to one (see 5.4.2). A wait for rearm bit set to zero specifies that the interrupt 
coalescing timer is reset and started upon the sending of a prior interrupt. The wait for rearm bit may be 
changed using the CHANGE OPERATIONAL OQ PROPERTIES function (see 10.2.10). 

The coalescing count field specifies a number of occupied operational OQ element array entries used for 
interrupt coalescing (see 5.4.2 and 5.2.5.12.10). The coalescing count field may be changed using the 
CHANGE OPERATIONAL OQ PROPERTIES function (see 10.2.10). 

The minimum coalescing time field specifies a minimum coalescing time in 100 ns intervals (see 5.4.2 and 

5.2.5.12.8) . If the minimum coalescing time field is greater than the maximum coalescing time field, then the 
minimum coalescing time shall be set to zero. If the minimum coalescing time field is set to a value other than 
zero that is not a multiple of the interrupt coalescing time granularity field in the REPORT PQI DEVICE 
CAPABILITY parameter data (see 10.2.2.3), then the minimum coalescing time in the PQI device shall be 
rounded up to the next multiple of the interrupt coalescing time gfranularity field (e.g., if the minimum 
coalescing time field is set to 21 and the interrupt coalescing time granularity field is set to 10, then the 
minimum coalescing time shall be rounded up to 30). The minimum coalescing time field may be changed using 
the CHANGE OPERATIONAL OQ PROPERTIES function (see 10.2.10). 

The maximum coalescing time field specifies a maximum coalescing time in 100 ns intervals (see 5.4.2 and 

5.2.5.12.9) . If the maximum coalescing time field is set to a value other than zero that is not a multiple of the 
INTERRUPT coalescing time granularity field in the REPORT PQI DEVICE CAPABILITY parameter data (see 
10.2.2.3), then the maximum coalescing time in the PQI device shall be rounded up to the next multiple of the 
interrupt coalescing time granularity field (e.g., if the maximum coalescing time field is set to 53 and the 
interrupt coalescing time granularity field is set to 10, then the maximum coalescing time shall be rounded 
up to 60). The maximum coalescing time field may be changed using the CHANGE OPERATIONAL OQ 
PROPERTIES function (see 10.2.10). 
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10.2.6.2 CREATE OPERATIONAL OQ response 


Table 87 defines the CREATE OPERATIONAL OQ response. 


Table 87 — CREATE OPERATIONAL OQ response 


Byte\Bit 


IU TYPE (EOh) 


PQI COMPATIBLE FEATURES (Oh) 


(LSB) 


3 

(MSB) 

IU LENGTH (003Ch) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (11 h) 

11 

STATUS 

12 






Additional status descriptor 


15 




16 



(LSB) 



OQ Cl OFFSET 


23 

(MSB) 



24 






Reserved 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 87 for the CREATE OPERATIONAL OQ response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 87 for the CREATE 
OPERATIONAL OQ response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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If the status field is set to GOOD (see 10.1.5.1), then: 

a) the oq ci offset field indicates the offset in PQI device memory space of the operational OQ Cl (i.e., the 
operational OQ Cl address is the memory address contained by the first PCI memory BAR plus the OQ Cl 
offset field); and 

b) byte 0 bits 1 to 0 of the oq ci offset field shall be set to 00b. 

If the status field is not set to GOOD, then the oq ci offset field is invalid. 

10.2.7 DELETE OPERATIONAL IQ function 


10.2.7.1 DELETE OPERATIONAL IQ request 


The DELETE OPERATIONAL IQ function requests that the PQI device management device server delete the 
specified operational IQ. 

See 5.3.4.3 for information on when it is safe to delete an operational IQ. 

Table 88 defines the DELETE OPERATIONAL IQ request. 

Table 88 — DELETE OPERATIONAL IQ request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (12h) 

11 

RsvdC 

12 


IQ ID 

(LSB) 

13 

(MSB) 


14 

RsvdC 


63 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 88 for the DELETE OPERATIONAL IQ requests. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 
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The request identifier field is defined in 10.1.4. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 88 for the DELETE 
OPERATIONAL IQ requests. 

The iq id field specifies the IQ ID (see 5.2.5.9.2) of the operational IQ to be deleted. If the iq id field is set to an IQ 
ID that does not exist, then the PQI device management device server shall return a DELETE OPERATIONAL IQ 
response with the status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

10.2.7.2 DELETE OPERATIONAL IQ response 

Table 89 defines the DELETE OPERATIONAL IQ response. 


Table 89 — DELETE OPERATIONAL IQ response 


Byte\Bit 

7 6 5 4 3 210 

0 

IU TYPE (E0h) 

1 

pqi compatible features (Oh) Reserved 

2 

(LSB) 

3 

(MSB) 

4 


5 

Reserved 

6 


7 

work area 

8 

(LSB) 

9 

REQUEST IDENTIFIER 

(MSB) 

10 

FUNCTION CODE (12h) 

11 

STATUS 

12 


15 

Additional status descriptor 

16 


63 

Reserved 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 89 for the DELETE OPERATIONAL IQ response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The REQUEST identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and shall be set as shown in table 89 for the DELETE 
OPERATIONAL IQ response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.8 DELETE OPERATIONAL OQ function 
10.2.8.1 DELETE OPERATIONAL OQ request 


The DELETE OPERATIONAL OQ function requests that the PQI device management device server delete the 
specified operational OQ. 

See 5.3.4.3 for information on when it is safe to delete an operational OQ. 

Table 90 defines the DELETE OPERATIONAL OQ request. 


Table 90 — DELETE OPERATIONAL OQ request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (13h) 

11 

RsvdC 

12 


OQ ID 

(LSB) 

13 

(MSB) 


14 

RsvdC 


63 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 90 for the DELETE OPERATIONAL OQ request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The request identifier field is defined in 10.1.4. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 90 for the DELETE 
OPERATIONAL OQ request. 
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The oq id field specifies the OQ ID (see 5.2.5.12.2) of the operational OQ to be deleted. If the oq id field is set to 
an OQ ID that does not exist, then the PQI device management device server shall return a DELETE 
OPERATIONAL OQ response with the status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

10.2.8.2 DELETE OPERATIONAL OQ response 


Table 91 defines the DELETE OPERATIONAL OQ response. 


Table 91 — DELETE OPERATIONAL OQ response 


Byte\Bit 


IU TYPE (E0h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE (13h) 


15 

16 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 91 for the DELETE OPERATIONAL OQ response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and shall be set as shown in table 91 for the DELETE 
OPERATIONAL OQ response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.9 CHANGE OPERATIONAL IQ PROPERTIES function 
10.2.9.1 CHANGE OPERATIONAL IQ PROPERTIES request 

The CHANGE OPERATIONAL IQ PROPERTIES function requests that the PQI device management device 
server change the properties of the specified operational IQ. 

Table 92 defines the CHANGE OPERATIONAL IQ PROPERTIES request. 


Table 92 — CHANGE OPERATIONAL IQ PROPERTIES request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (14h) 

11 

RsvdC 

12 


IQ ID 

(LSB) 

13 

(MSB) 


14 

RsvdC 


59 


60 

Vendor specific 


63 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 92 for the CHANGE OPERATIONAL IQ PROPERTIES request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The REQUEST identifier field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and shall be set as shown in table 92 for the CHANGE 
OPERATIONAL IQ PROPERTIES request. 
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The IQ id field specifies the IQ ID (see 5.2.5.9.2) of the operational IQ to be configured. If the IQ id field is set to an 
IQ ID that does not exist, then the PQI device management device server shall return a CHANGE 
OPERATIONAL IQ PROPERTIES response with the status field set to INVALID FIELD IN REQUEST IU (see 
10.1.5.3). 


10.2.9.2 CHANGE OPERATIONAL IQ PROPERTIES response 

Table 93 defines the CHANGE OPERATIONAL IQ PROPERTIES response. 

Table 93 — CHANGE OPERATIONAL IQ PROPERTIES response 


Byte\Bit 


IU TYPE (E0h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


WORK AREA 


10 

11 


(MSB) 


REQUEST IDENTIFIER 

FUNCTION CODE (14h) 
STATUS 


(LSB) 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 93 for the CHANGE OPERATIONAL IQ PROPERTIES response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 93 for the CHANGE 
OPERATIONAL IQ PROPERTIES response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.10 CHANGE OPERATIONAL OQ PROPERTIES function 
10.2.10.1 CHANGE OPERATIONAL OQ PROPERTIES request 

The CHANGE OPERATIONAL OQ PROPERTIES function requests that the PQI device management device 
server change the properties of the specified operational OQ. 

Table 94 defines the CHANGE OPERATIONAL OQ PROPERTIES request. 

Table 94 — CHANGE OPERATIONAL OQ PROPERTIES request (part 1 of 2) 


6 

5 

4 

3 

2 

1 


Byte\Bit 


IU TYPE (60h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


WORK AREA 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE (15h) 


(MSB) 


(LSB) 


41 

42 


WAIT FOR MSI-X 

REARM DISABLE 


(MSB) 


COALESCING COUNT 


(LSB) 


(MSB) 


MINIMUM COALESCING TIME 


(LSB) 
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The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 94 for the CHANGE OPERATIONAL OQ PROPERTIES request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The REQUEST identifier field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and shall be set as shown in table 94 for the CHANGE 
OPERATIONAL OQ PROPERTIES function. 

If the Cic bit is set to zero in the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3), then: 

a) the oq id field specifies the OQ ID (see 5.2.5.12.2) of the operational OQ to be configured; and 

b) if the oq id field is set to an OQ ID that does not exist, then the PQI device management device server 
shall return a CHANGE OPERATIONAL OQ PROPERTIES response with the status field set to 
INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

If the Cic bit is set to one in the REPORT PQI DEVICE CAPABILITY parameter data (see 10.2.2.3), then: 

a) if no operational OQs exist, then the PQI device management device server shall return a CHANGE 
OPERATIONAL OQ PROPERTIES response with the status field set to INVALID FIELD IN REQUEST 
IU (see 10.1.5.3); and 

b) if one or more operational OQs exist, then: 

A) the oq id field shall be ignored; 

B) the Coalescing Count attribute for all operational OQs shall be set to the value of the coalescing 
count field; 

C) the Minimum Coalescing Time attribute for all operational OQs shall be set to the value of the 
MINIMUM COALESCING TIME field; 

D) the Maximum Coalescing Time attribute for all operational OQs shall be set to the value of the 
maximum coalescing time field; and 

E) the Wait For Rearm attribute for all operational OQs shall be set to value of the wait for rearm bit. 

| The wait for rearm bit, the msi-x disable bit, the coalescing count field, the minimum coalescing time field, 
and the maximum coalescing time field are defined in the CREATE OPERATIONAL OQ request (see 10.2.6.1). 
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10.2.10.2 CHANGE OPERATIONAL OQ PROPERTIES response 

Table 95 defines the CHANGE OPERATIONAL OQ PROPERTIES response. 

Table 95 — CHANGE OPERATIONAL OQ PROPERTIES response 


Byte\Bit 


IU TYPE (E0h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE (15h) 


15 

16 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 95 for the CHANGE OPERATIONAL OQ PROPERTIES response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 95 for the CHANGE 
OPERATIONAL OQ PROPERTIES response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.11 REPORT OPERATIONAL IQ LIST function 
10.2.11.1 REPORT OPERATIONAL IQ LIST request 

The REPORT IQ LIST function requests that the PQI device management device server return a list of all 
existing operational IQs and their properties in the Data-In Buffer as defined in 10.2.11.3. 

Table 96 defines the REPORT OPERATIONAL IQ LIST request. 


Table 96 — REPORT OPERATIONAL IQ LIST request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (16h) 

11 

RsvdC 


43 


44 

DATA-IN BUFFER SIZE 

(MSB) 

(LSB) 

47 


48 

SGL descriptor (see table 53) 


63 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 96 for the REPORT OPERATIONAL IQ LIST request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The request identifier field is defined in 10.1.4. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 96 for the REPORT 
OPERATIONAL IQ LIST request. 
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The data-in buffer size field is defined in 10.1.4. 

The SGL descriptor is defined in 10.1.4. 

10.2.11.2 REPORT OPERATIONAL IQ LIST response 


Table 97 defines the REPORT OPERATIONAL IQ LIST response. 


Table 97 — REPORT OPERATIONAL IQ LIST response 


Byte\Bit 


IU TYPE (E0h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE (16h) 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 97 for the REPORT OPERATIONAL IQ LIST response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The REQUEST identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and shall be set as shown in table 97 for the REPORT 
OPERATIONAL IQ LIST response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.11.3 REPORT OPERATIONAL IQ LIST parameter data 

Table 98 defines the REPORT OPERATIONAL IQ LIST parameter data. 


Table 98 — REPORT OPERATIONAL IQ LIST parameter data (i.e., Data-In Buffer contents) 


Byte\Bit 

7 6 5 4 3 2 1 0 

0 


5 

Reserved 

6 

(LSB) 

7 

NUMBER OF OPERATIONAL IQ PROPERTY DESCRIPTORS 

(MSB) 

Operational IQ property descriptor list 

8 


135 

Operational IQ property descriptor [first] (see table 99) 



m-127 


m 

Operational IQ property descriptor [last] (see table 99) 


The number of operational IQ property descriptors field indicates the number of operational IQ property 
descriptors in the operational IQ property descriptor list. 

Table 99 defines the operational IQ property descriptor. 


Table 99 — Operational IQ property descriptor (part 1 of 2) 


Byte\Bit 

7 6 5 4 3 2 1 0 

0 



Reserved 

11 


12 

(LSB) 

13 

(MSB) 

14 

Reserved frozen iq error 

15 

Reserved 

16 

(LSB) 


IQ ELEMENT ARRAY ADDRESS 

23 

(MSB) 
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I 


Table 99 — Operational IQ property descriptor (part 2 of 2) 


Byte\Bit 7 6 5 4 3 2 1 0 


24 

(LSB) 

31 

IQ Cl ADDRESS 

(MSB) 

32 

(LSB) 

33 

(MSB) 

34 

(LSB) 

35 

(MSB) 

36 

Reserved operational queue protocol 

37 

Reserved arbitration priority 

3738 


59 

Reserved 

60 


63 

Vendor specific 

Bytes corresponding to the CREATE OPERATIONAL IQ response 

64 

(LSB) 

71 

IQ PI OFFSET 

(MSB) 

72 


127 

Reserved 


The IQ id field indicates the IQ ID (see 5.2.5.9.2) of the operational IQ being described. 

An iq error bit set to one indicates that the PQI device has stopped consuming from the operational IQ due to 
an error. An iq error bit set to zero indicates that the PQI device has not stopped consuming from the 
operational IQ due to an error. 

A frozen bit set to one indicates the operational IQ is frozen. A frozen bit set to zero indicates that the 

operational IQ is not frozen. 

The iq element array address field indicates the operational IQ element array address. 

The iq ci address field indicates the operational IQ Cl address. 

The number of elements field indicates the number of elements in the operational IQ element array. 

The element length field indicates the element length in 16-byte increments (e.g., a value of 0001 h in the 
element length field specifies an element length of 16 bytes). 
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The operational queue protocol field (see table 83) indicates the operational queue protocol used by the 
operational IQ (see 5.3.1). 

The arbitration priority field indicates the arbitration priority with which the operational IQ is associated and is 

defined in table 84. 

The iq pi offset field indicates the offset in PQI device memory space of the operational IQ PI (i.e., the 
operational IQ PI address is the memory address contained in the first PCI memory BAR plus the IQ pi offset 
field). 
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10.2.12 REPORT OPERATIONAL OQ LIST function 
10.2.12.1 REPORT OPERATIONAL OQ LIST request 

The REPORT OPERATIONAL OQ LIST function requests that the PQI device management device server return 
a list of ail existing operational OQs and their properties in the Data-In Buffer as defined in 10.2.12.3. 

Table 100 defines the REPORT OPERATIONAL OQ LIST request. 


Table 100 — REPORT OPERATIONAL OQ LIST request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 


IU LENGTH (003Ch) 

(LSB) 

3 

(MSB) 


4 


Reserved 


5 



6 


WORK AREA 


7 



8 


REQUEST IDENTIFIER 

(LSB) 

9 

(MSB) 


10 

FUNCTION CODE (17h) 

11 

RsvdC 


43 


44 

DATA-IN BUFFER SIZE 

(MSB) 

(LSB) 

47 


48 

SGL descriptor (see table 53) 


63 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 
set as shown in table 100 for the REPORT OPERATIONAL OQ LIST request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The request identifier field is defined in 10.1.4. 

The FUNCTION CODE field is defined in 10.2.1 and shall be set as shown in table 100 for the REPORT 
OPERATIONAL OQ LIST request. 
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The data-in buffer size field is defined in 10.1.4. 
The SGL descriptor is defined in 10.1.4. 


10.2.12.2 REPORT OPERATIONAL OQ LIST response 

Table 101 defines the REPORT OPERATIONAL OQ LIST response. 

Table 101 — REPORT OPERATIONAL OQ LIST response 


Byte\Bit 


IU TYPE (E0h) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


(MSB) 


REQUEST IDENTIFIER 


(LSB) 


FUNCTION CODE (17h) 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 
set as shown in table 101 for the REPORT OPERATIONAL OQ LIST response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The REQUEST identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and shall be set as shown in table 101 for the REPORT 
OPERATIONAL OQ LIST response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.12.3 REPORT OPERATIONAL OQ LIST parameter data 

Table 102 defines the REPORT OPERATIONAL OQ LIST parameter data. 


Table 102 — REPORT OPERATIONAL OQ LIST parameter data (i.e., Data-In Buffer contents) 


Byte\Bit 

7 6 5 4 3 2 1 0 

0 


5 

Reserved 

6 

(LSB) 

7 

NUMBER OF OPERATIONAL OQ PROPERTY DESCRIPTORS 

(MSB) 

Operational OQ property descriptor list 

8 


135 

Operational OQ property descriptor [first] (see table 103) 



m-127 


m 

Operational OQ property descriptor [last] (see table 103) 


The number of operational OQ property descriptors field indicates the number of operational OQ property 
descriptors in the operational OQ property descriptor list. 
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Table 103 defines the operational OQ property descriptor. 

Table 103 — Operational OQ property descriptor (part 1 of 2) 


Byte\Bit 

7 

6 

5 4 3 

2 1 

0 

0 





Reserved 


11 



12 


OQ ID 

(LSB) 

13 

(MSB) 


14 

Reserved 

OQ 

ERROR 

15 

Reserved 

16 


(LSB) 



OQ ELEMENT ARRAY ADDRESS 


23 

(MSB) 


24 


(LSB) 



OQ PI ADDRESS 


31 

(MSB) 


32 


NUMBER OF ELEMENTS 

(LSB) 

33 

(MSB) 


34 


ELEMENT LENGTH 

(LSB) 

35 

(MSB) 


36 

Reserved operational queue protocol 

37 





Reserved 


39 



40 

INTERRUPT MESSAGE NUMBER (LSB) 

41 

WAIT FOR 

REARM 

MSI-X 

DISABLE 

Reserved 

(MSB) 

42 


COALESCING COUNT 

(LSB) 

43 

(MSB) 


44 

MINIMUM COALESCING TIME 

(MSB) 

(LSB) 

47 
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Table 103 — Operational OQ property descriptor (part 2 of 2) 


Byte\Bit 


MAXIMUM COALESCING TIME 


51 (MSB) 


(LSB) 


Vendor specific 


Bytes corresponding to the CREATE OPERATIONAL OQ response 


OQ Cl OFFSET 


71 (MSB) 


(LSB) 


The OQ id field indicates the OQ ID (see 5.2.5.12.2) of the operational OQ being described. 

An oq error bit set to one indicates that the PQI device has stopped producing to the operational OQ due to an 
error. An oq error bit set to zero indicates that the PQI device is producing to the operational OQ. 

The oq element array address field indicates the operational OQ element array address. 

The oq pi address field indicates the operational QQ PI address. 

The number of elements field indicates the number of elements in the operational OQ element array. 

The element length field indicates the length in 16-byte increments of elements in the operational OQ (e.g., a 
value of 01 h in the element length field specifies an element length of 16 bytes). 

The operational queue protocol field (see table 83) indicates the operational queue protocol used by the 
operational OQ (see 5.3.1). 

The interrupt message number field indicates the MSI-X Table entry used to generate the interrupt message for 
updates to the operational OQ PI in MSI-X mode (see PCI). 

The WAIT FOR REARM bit, the COALESCING count field, the MINIMUM COALESCING time field, and the MAXIMUM 
coalescing time field control interrupt coalescing parameters in MSI-X mode (see 5.4.2.3). 

The wait for rearm bit is defined in 10.2.6.1. 

The msi-x disable bit is defined in 10.2.6.1. 

The coalescing count field is defined in 10.2.6.1. 

The MINIMUM COALESCING time field is defined in 10.2.6.1. 

The maximum coalescing time field is defined in 10.2.6.1. 
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The oq ci offset field indicates the offset in PQI device memory space of the operational OQ Cl (i.e., the 
operational OQ Cl address is the memory address contained in the first PCI memory BAR plus the OQ Cl offset 
field). 


10.2.13 FREEZE OPERATIONAL IQ function 
10.2.13.1 FREEZE OPERATIONAL IQ request 

The FREEZE OPERATIONAL IQ function requests that the specified operational IQ be frozen. 

The IQ Cl of the specified operational IQ shall be updated and the specified operational IQ shall be frozen prior to 

the sending the FREEZE OPERATIONAL IQ response. 

After an operational IQ is frozen, the PQI host may: 

a) alter the content of the operational IQ elements on the specified operational IQ: or 

b) modify the PI of the specified operational IQ. 

Table 104 defines the FREEZE OPERATIONAL IQ request. 

Table 104 — FREEZE OPERATIONAL IQ request 


Byte\Bit 

7 

6 

5 

4 

3 

2 

1 

Q 

0 

IU TYPE (60ht 

1 

PQI COMPATIBLE FEATURES fOht 

Reserved 

2 




IU LENGTH (003Ch1 



(LSB1 

3 

(MSBI 






4 




Reserved 




5 







6 









7 




vvwr\r\ MrxCM 




8 








(LSBI 

9 

(MSB) 



1 1LJ Cl N 1 IrlCrx 




10 

FUNCTION CODE (18h1 

11 

RsvdC 

12 







(LSB) 

13 

(MSB) 








14 













RsvdC 




63 










The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 

set to as shown in table 104 for the FREEZE OPERATIONAL IQ request. 
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The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 

The REQUEST identifier field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and is set to the value shown in table 104 for the FREEZE 

OPERATIONAL IQ request. 

The IQ id field specifies the IQ ID (see 5.2.5.9.2) of the operational IQ to be frozen. If the IQ id field is set to an IQ 

ID that does not exist, then the PQI device management device server shall return a FREEZE OPERATIONAL 

IQ response with the status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

10.2.13.2 FREEZE OPERATIONAL IQ response 


Table 105 defines the FREEZE OPERATIONAL IQ response. 

Table 105 — FREEZE OPERATIONAL IQ response 


Bvte\Bit 


IU TYPE (EOh) 


PQI COMPATIBLE FEATURES (Oh) 


(MSB) 


IU LENGTH (003Ch) 


(LSB) 


WORK AREA 


REQUEST IDENTIFIER 


(LSB) 


(MSB) 


FUNCTION CODE (18h) 


Additional status descriptor 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 

set as shown in table 105 for the FREEZE OPERATIONAL IQ response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The REQUEST identifier field is defined in 10.1.5.1. 
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The function code field is defined in 10.2.1 and is set to the value shown in table 105 for the FREEZE 

OPERATIONAL IQ response. 

The status field and the additional status descriptor are defined in 10.1.5. 


10.2.14 UNFREEZE OPERATIONAL IQ function (all new) 

10.2.14.1 UNFREEZE OPERATIONAL IQ request 

The UNFREEZE OPERATIONAL IQ function requests that the specified operational IQ no longer be frozen. 

Table 106 defines the UNFREEZE OPERATIONAL IQ request. 

Table 106 — UNFREEZE OPERATIONAL IQ request 


Bvte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE (60h) 

1 

PQI COMPATIBLE FEATURES (Oh) 

Reserved 

2 




IU LENGTH (003Ch) 



(LSB) 

3 

(MSB) 






4 




Reserved 




5 







6 









7 




VVURA MrxtZM 




8 








(LSB) 

9 

(MSB) 



r\izwucio i iuo\iiricr\ 




10 

FUNCTION CODE (19h) 

11 

RsvdC 

12 







(LSB) 

13 

(MSB) 








14 













RsvdC 




63 










The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 

set to as shown in table 106 for the UNFREEZE OPERATIONAL IQ request. 

The work area field may be set to any value by the PQI host and shall be ignored by the PQI device. 


The request identifier field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and is set to the value shown in table 106 for the UNFREEZE 

OPERATIONAL IQ request. 
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The iq id field specifies the IQ ID (see 5.2.5.9. 2) of the operational IQ to be unfrozen. If the iq id field is set to an 

IQ ID that does not exist, then the PQI device management device server shall return a UNFREEZE 

OPERATIONAL IQ response with the status field set to INVALID FIELD IN REQUEST IU (see 10.1.5.3). 

10.2.14.2 UNFREEZE OPERATIONAL IQ response 

Table 107 defines the UNFREEZE OPERATIONAL IQ response. 

Table 107 — UNFREEZE OPERATIONAL IQ response 


Bvte\Bit 

7 

6 

5 

4 

3 

2 

1 

0 

0 

IU TYPE tEOht 

1 

PQI COMPATIBLE FEATURES tOht 

Reserved 

2 




IU LENGTH (003Ch1 



(LSB) 

3 

(MSB) 






4 




Reserved 




5 







6 









7 




VVUr\l\ nt\Cn 




8 








(LSB) 

9 

(MSB) 



rrcouco i iljcin i incr\ 




10 

FUNCTION CODE M9h1 

H 

STATUS 

12 












Additional status descriDtor 



15 









16 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 

set as shown in table 107 for the UNFREEZE OPERATIONAL IQ response. 

The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The request identifier field is defined in 10.1.5.1. 

The function code field is defined in 10.2.1 and is set to the value shown in table 107 for the UNFREEZE 

OPERATIONAL IQ response. 

The status field and the additional status descriptor are defined in 10.1.5. 
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10.2.15 CONFIGURE IQ ARBITRATION function 
10.2.15.1 CONFIGURE IQ ARBITRATION request 

The CONFIGURE IQ ARBITRATION function requests that the PQI device modify the IQ arbitration parameters. 

Figure 108 defines the CONFIGURE IQ ARBITRATION request. 



The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.4 and shall be 

set as shown in table 82 for the CREATE OPERATIONAL IQ request. 

The work area field may be set to any value by the PQI host and shall be ignored. 

The REQUEST identifier field is defined in 10.1.4. 

The function code field is defined in 10.2.1 and shall be set as shown in table 108 for the CONFIGURE IQ 

ARBITRATION request. 
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The aw A field specifies the weight value that is used by IQ arbitration for the weighted round robin A arbitration 

priority (see 5.3.5V 

The aw B field specifies the weight value that is used by IQ arbitration for the weighted round robin B arbitration 

priority (see 5.3.5). 

The aw c field specifies the weight value that is used by IQ arbitration for the weighted round robin C arbitration 

priority (see 5.3.5V 

The arbitration burst field specifies the maximum elements that may be consumed from an IQ that is using 

round robin or weighted round robin arbitration at one time. This value is specified as 2 D . A value of 111b 

indicates no limit. The possible settings are 1,2, 4, 8, 16, 32, 64, or no limit. 

10.2.15.2 CONFIGURE IQ ARBITRATION response 

Table 109 defines the CONFIGURE IQ ARBITRATION response. 


Table 109 — CONFIGURE IQ ARBITRATION response 


IU TYPE (EOht 


PQI COMPATIBLE FEATURES (Oh) 


(MSBt 


IU LENGTH (003Cm 


(LSBt 


(LSB) 


REQUEST IDENTIFIER 


(MSBt 


FUNCTION CODE (18h) 


Additional status descriptor 


15 

16 


The iu type field, the pqi compatible features field, and the iu length field are defined in 10.1.5 and shall be 

set as shown in table 109 for the CONFIGURE IQ ARBITRATION response. 
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The work area field may be set to any value by the PQI device and should be ignored by the PQI host. 

The REQUEST identifier field is defined in 10.1.5.1. 
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Alternative SGL segment 

An alternative SGL segment (see table A.2): 

a) is a kind of SGL segment (see 8.2) pointed to by a Last Alternative SGL Segment descriptor (see table 
A.1); and 

b) contains Alternative Data Block descriptors (see table A.3). 

The length and format of the Alternative Data Block descriptor differs from that of the SGL descriptors defined in 
8.3 (i.e., 20 bytes rather than 16 bytes). 

An alternative SGL segment is a last SGL segment. 

Table A.1 defines the Last Alternative SGL Segment descriptor. 


Table A.1 — Last Alternative SGL Segment descriptor 


Byte\Bit 

7 6 5 4 3 2 

1 0 

0 

(LSB) 

Reserved 

7 

ADDRESS 

(MSB) 

8 

NUMBER OF DESCRIPTORS 

(MSB) 

(LSB) 

11 


12 

Reserved 


14 


15 

sgl descriptor type (4h) Reserved 


The address field specifies the upper 62 bits of the 64-bit memory space address of the next SGL segment, 
which is the last SGL segment (see 8.2) and is an alternative SGL segment (see table A.2). The least significant 
two bits of the 64-bit memory space address of the next SGL segment, which are not specified by the address 
field, are zero. 

The number of descriptors field specifies the number of Alternative Data Block descriptors in the alternative 
SGL segment. If the number of descriptors field is set to zero, then the Alternative Data Block descriptor shall 
be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

If the value in the address field plus the value in the number of descriptors field times 20 (i.e., the length in 
bytes of each Alternative Data Block descriptor) is greater than 1_00000000_00000000h, then the Alternative 
Data Block descriptor shall be processed as having an error (see 10.1.4 and the IU layer standard (e.g., SOP)). 

The sgl descriptor type field is defined in 8.3.1 and shall be set as shown in table A.1 for the Last Alternative 
SGL Segment descriptor. 
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Table A.2 defines the alternative SGL segment. 


Table A.2 — Alternative SGL segment 


Byte\Bit 

7 6 5 4 3 2 1 ° 

0 


19 

Alternative Data Block descriptor [first] (see table A.3) 



n -19 


n 

Alternative Data Block descriptor [last] (see table A.3) 


The alternative SGL segment shall contain at least one Alternative Data Block descriptor. 
Table A.3 defines the Alternative Data Block descriptor. 


Table A.3 — Alternative Data Block descriptor 


Byte\Bit 

7 6 5 4 3 2 1 ° 

0 

(LSB) 


ADDRESS 

7 

(MSB) 

8 

(LSB) 


LENGTH 

11 

(MSB) 

12 



Vendor specific 

19 



The address field specifies the starting 64-bit memory address of a data block. 

The length field specifies the length in bytes of the data block. A length field set to OOOOOOOOh specifies that no 
data is transferred. An Alternative Data Block descriptor specifying that no data is transferred shall not be 
processed as having an error. 

If the value in the address field plus the value in the length field is greater than 1_00000000_00000000h, then 
the Alternative Data Block descriptor shall be processed as having an error (see 10.1.4 and the III layer standard 
(e.g., SOP)). 
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Operating system suggestions 

B.1 Power actions 

If a Windows® operating system Storport miniport driver’s HwStorBuildlo function is invoked with an Srb 
parameter pointing to a SCSI_POWER_REQUEST BLOCK (i.e., the Function member is set to 
SRBFUNCTIONPOWER), then the miniport driver should set the fields in the PQI Device Power Action 
register (see 6.2.21) as follows: 

a) set the system power action field as described in table B.1; and 


Table B.1 —Windows PowerAction member to system power action field 


PowerAction member 

SYSTEM POWER ACTION field 

0 (i.e., StorPowerActionNone) 

00h (i.e., no action) 

1 (i.e., StorPowerActionReserved) 

OOh (i.e., no action) 

2 (i.e., StorPowerActionSleep) 

lOh (i.e., S1.S2, or S3) 

3 (i.e., StorPowerActionHibernate) 

14h (i.e., S4) 

4 (i.e., StorPowerActionShutdown) 

02h (i.e., SO or S5) 

5 (i.e., StorPowerActionShutdownReset) 

01h(i.e„ SO) 

6 (i.e., StorPowerActionShutdownOff) 

15h (i.e., S5) 

7 (i.e., StorPowerActionWarmEject) 

OOh (i.e., no action) 


b) set the device power action field as described in table B.2. 

Table B.2 — Windows DevicePowerState member to device power action field 


DevicePowerState member 

DEVICE POWER ACTION field 

0 (i.e., StorPowerDeviceUnspecified) 

OOh (i.e., no action) 

1 (i.e., StorPowerDeviceDO) 

lOh (i.e., DO) 

2 (i.e., StorPowerDeviceDI) 

11 h (i.e., D1) 

3 (i.e., StorPowerDeviceD2) 

12h (i.e., D2) 

4 (i.e., StorPowerDeviceD3) 

13h (i.e., D3) 


NOTE 11 - Windows is a registered trademark of Microsoft Corporation in the United States and other countries. 

NOTE 12 - For information on Windows, see the Microsoft Developer Network web site (see http:// 
msdn.microsoft.com). 
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Annex C 

(informative) 

SGL examples 


C.1 Data transfer from a source data stream to a destination data buffer 

Figure C.1 shows an example of a data transfer from a source data stream to a destination data buffer in memory 
space described by an SGL. The total length of the source data stream is 13 KiB and the total length of the 
destination data buffer is 11 KiB. The destination data buffer is described by an SGL that contains three standard 
SGL segments. The three standard SGL segments contain a total of three Data Block descriptors with lengths of 
3 KiB, 4 KiB, and 4 KiB respectively. Standard SGL segment 1 of the Destination SGL contains a Bit Bucket 
descriptor (see 8.3.3) with a length of 2 KiB that specifies discarding (i.e., not transferring) 2 KiB of data of the 
source data stream. SGL segment 1 also contains a Last Standard SGL Segment descriptor (see 8.3.5) 
specifying that the standard SGL segment pointed to by the descriptor is the last standard SGL segment. 
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Figure C.1 — SGL example of a data transfer from a source data stream to a destination data buffer 
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C.2 Data transfer from a source data buffer to a destination data stream 

Figure C.2 shows an example of a data transfer from a source data buffer in memory space described by an SGL 
to a destination data stream. The total length of the destination data stream is 11 KiB and the total length of the 
source data buffer is 11 KiB. The source data buffer is described by an SGL that contains one standard SGL 
segment that contain three Data Block descriptors with lengths of 3 KiB, 4 KiB, and 4 KiB respectively. The 
source SGL also contains a Bit Bucket descriptor with a length of 2 KiB that is ignored because the SGL 
describes a source data buffer. 



PCI Express' 



Data Block 
descriptor specifies 
transferring 3 KiB 


Data Block 
descriptor specifies 
transferring 4 KiB 


Bit Bucket descriptor 
length field is 
ignored since the 
SGL describes a 
source data buffer 


Data Block 
descriptor specifies 
transferring 4 KiB 


Figure C.2 — SGL example of a data transfer from a source data buffer to a destination data stream 
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C.3 Memory to memory data transfer 

Figure C.3 shows an example of a 12 KiB memory to memory data transfer from a source data buffer described 
by an SGL to a destination data buffer described by an SGL. The total length of the destination data buffer is 12 
KiB and the total transferable length of the source data buffer is 12 KiB. The source data buffer is described by 
an SGL that contains one standard SGL segment that contains two Data Block descriptors (see 8.3.2) with 
lengths of 6 KiB and 6 KiB respectively. The destination data buffer is described by an SGL made up of one 
standard SGL segment that contains three SGL Data Buffer descriptors with lengths of 4 KiB, 4 KiB, and 4 KiB 
respectively. 


Data Block 
descriptor specifies 
transferring 4 KiB 

Data Block 
descriptor specifies 
transferring 4 KiB 

Data Block 
descriptor specifies 
transferring 4 KiB 


Data Block 
descriptor specifies 
transferring 6 KiB 


Data Block 
descriptor specifies 
transferring 6 KiB 


PQI device memory space 



Destination SGL 


Standard SGL segment 



address = data block A 



SGL DESCRIPTOR TYPE = 0 LENGTH = 4 KiB 



address = data block B 



SGL DESCRIPTOR TYPE = 0 LENGTH = 4 KiB 



address = data block C 



SGL DESCRIPTOR TYPE = 0 LENGTH = 4 KiB 












Source SGL 



Standard SGL segment 

address = data block D 

H 

F 

SGL DESCRIPTOR TYPE = 0 LENGTH = 6 KiB 


address = data block E 

H 

SGL DESCRIPTOR TYPE = 0 LENGTH = 6 KiB 





Figure C.3 — SGL example of a memory to memory data transfer 
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(informative) 


16 April 2015 


PQI host initialization and shut down sequence 
D.1 PQI host initialization sequence 

The PQI host should perform the following sequence to initialize the PQI device: 

1) identify the PCIe configuration (e.g., interrupt (see PCI) and power management (see PCD) and 

configure the PCIe registers (see PCIet: 

2) create the administrator gueue pair as described in 5.3.3.2: and 

3) create the operational gueues as described in 5.3.3.3. 


D.2 PQI host shut down sequence 

Before a power down of the host system or transitioning of the host system to the device power state D3 (see 

ACPI and PCI-PMt. the PQI host should perform the following seouence: 

1) stop engueuing new Ills to administrator IQ and operational IQs: 

2) if the PD state machine is in the PD3:Administrator Queue Pair Ready state (see 5.5.5. Itthen: 

A) if one or more operational IQs exist, then delete all operational IQs as described in 5.3.4.3: and 

B) if one or more operational OQs exist, then delete all operational OQs as described in 5.3.4.3: 

and 

3) delete the administrator oueue pair as described in 5.3.4.2. 

If a failure occurs, then initiate a PQI reset (see 5.7). 
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